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Preface 



This publication is intended primarily for users of the • IBM System/32 Basic Assembler and Macro Processor 
System/32 with an IBM 1 255 Magnetic Character Reader Reference Manual, SC21-7673 
attached. The reference portion is intended for program- 
mers, systems analysts and, occasionally, the operator. • IBM 1255 Magnetic Character Reader Component 
The program logic portion is intended for program support Description, GA24-3542 
representatives and customer engineers. 

• IBM System/32 Displayed Messages Guide 
The reader should be familiar with System/32, with the GC2 1-7704 

1255 Magnetic Character Reader, and with RPG II (Program 

Number 5725-RG1 ) or basic assembler programming • IBM System/32 1255 A ttachment Feature 
(Program Number 5725-AS1). If more information is Theory-Diagrams, SY31-0468 

required, refer to: 

• IBM System/32 Functions Reference Manual, 
GA21-9176 

• IBM System/32 RPG II Reference Manual, SC2 1 -7595 



Second Edition (November 1977) 

This is a major revision of, and obsoletes GC21 -7692. Changes have been made through- 
out the entire manual, and the following enhancements have been added : geometric 
modulus checking of the account number, allowance of greater than four field compar- 
ison tests per stacker selection, and the account number field to be greater than 10 digits 
and the process control field to be greater than 6 digits in length on an input document. 

This edition applies to version 02 modification 00 of the IBM System/32 System Control 
Program 5725-SC1 , and to all subsequent versions and modifications until otherwise 
indicated in new editions or technical newsletters. Changes are continually made to the 
specifications herein; before using this publication in connection with the operation of 
IBM systems, refer to the latest IBM System/32 Bibliography, GC20-O032, for the 
editions that are applicable and current. 

Requests for copies of IBM publications should be made to your IBM representative 
or to the IBM branch office serving your locality. 

A form for readers' comment is at the back of this publication. If the form is missing, 
address your comments to IBM Corporation, Publications, Department 245, Rochester, 
Minnesota 55901 . 
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Part 1. 1255 Reference and Operating Procedures 



Part 1 includes the following chapters: 

Chapter 1. Introduction to 1255 Reference and Operating 
Procedures: Describes the 1255 Models 1, 2, and 3 and the 
characteristics of the input document. 

Chapter 2. How to Complete System and Stacker 
'Specifications: Contains column description of the 
entries necessary to complete the system and stacker 
specifications. 

Chapter 3. Opera ting Procedures and Considerations: 
Tells how to start and operate the 1255 including 1255 
stop conditions. 

Chapter 4. Error Detection and Checking: Descri bes error 
conditions that can occur while System/32 is operated with 
a 1255 attached. 

Chapter 5. Considerations for Writing an RPG II Program 
That Contains SUBR08: Tells how to code the RPG 1 1 
specification sheets and example programs. 

Chapter 6. Coding Necessary to Write and Assembler 
Language Program Containing SUBR08: Coding example 
of an assembler program using SUBR08. 

Chapter 7. 1255 Functions: Machine code level 
instructions for System/32 to interface with a 1255. 
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Chapter 1. Introduction to 1255 Reference and Operation Procedures 



The 1255 Models 1, 2, and 3 are designed for demand 
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are printed with magnetic ink characters. Refer to 
Characteristics of Input Documents in this chapter for 
more information. 

System and stacker specifications (see Chapter 2) are 
included with a user-written RPG II or assembler language 
program. The resulting program enables the System/32 
to read documents from the 1255 and route them to the 
specified stackers. 



DEVICE CHARACTERISTICS 

The 1 255 Model 1 reads and/or sorts up to 500 6-inch 
documents per minute into six stackers. Model 2 reads 
and/or sorts up to 750 6-inch documents per minute into 
six stackers. 




1255 Models 1 and 2 Magnetic Character Reader 

Model 3 reads and/or sorts up to 750 6-inch documents 
per minute into 12 stackers. 




1255 Model 3 Magnetic Character Reader 

Figure 1-1 summarizes the stacker configuration and the 
rated throughput (for documents 6 inches in length) for 
the 1255 Models 1,2, and 3. 
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1255-1 


6 


2.5-inch stack 


500 


1255-2 


6 


2. 5- inch stack 


750 


1255-3 


12 


2. 5- inch stack 


750 



Figure 1-1. Summary of Rated Throughput for 1255 

Both devices perform at maximum speed if the feed clutch 
does not disengage. SUBR08 is designed to permit the 
1255 to perform without disengaging. However, the rest 
of the program must be written so that the other devices 
can keep up. 
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1255 OPTIONAL FEATURE 

The Dash Symbol Transmission feature (Feature Number 
321 5) is available for use with the 1255. This feature 
transmits a dash symbol from the transit-routing field 
to storage. 



CHARACTERISTICS OF INPUT DOCUMENTS 

The 1255 reads MICR (magnetic ink character recognition)- 
encoded documents. The information read from these 
documents must be printed with the MICR E-13B font 
in magnetic ink, near the bottom edge. Each document 
can contain a maximum of 53 characters (45 digits plus 8 
special symbols) in five fields. With the dash symbol 
transmission feature installed, each document can contain 
45 digits plus 9 special symbols for a maximum of 54 
characters. 

The E-13B font must be printed as recommended by the 
American Bankers Association (ABA) Technical Committee 
on the Mechanization of Check Handling. Symbols 
available on the E-13B font are shown in Figure 1-2. 
A typical document is shown in Figure 1-3. 
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Figure 1-2. E-13B Font Symbols 
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Figure 1-3. Typical Document Containing Magnetic Ink Printing 

The number of characters in each field varies according 
to the type of field. Dashes and spaces can be included, 
but are not counted as character positions, unless the 
Dash Symbol Transmission feature is used. Then a dash 
can be indicated in the transit-routing field and counted as 
a character position. 

Dashes and spaces are ignored when the 1255 determines 
the digit portion of a number for sorting. For example, 
in a right-to-left reading, the 1 in 0210-0987 is in sort 
position 6. 

Documents are loaded into the hopper face down with the 
MICR edge against the backguide. The MICR-encoded ink 
characters are read from right to left as a document passes 
through the read head station. The fields are described in 
the same sequence as they are read (see Figure 1-4). 
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The fields on a document are read serially from right to left 
and are described in that manner in the following para- 
graphs. The special symbols for designating a field are not 
restricted to a specific location for a field. That is, a 10- 
digit variable-length field that has an entry of 6 digits can 
have the special symbol positioned immediately following 
the leftmost digit. 

D Amount is a fixed-length field of 10 or 11 digits. A 

10-digit amount field is standard in the United States, 
but 1 1 digits can be used. The amount field must be 
enclosed by amount ( i*' ) symbols. 



Note: If the process control field specified is larger than 6 
digits or the account number field specified is larger than 
10 digits, the total size of both fields accumulated cannot 
be greater than 16 digits. 

U Transit- Routing is an 8-digit, fixed length field. It 
must be enclosed by transit ( ij ) symbols and can 
contain either two 4-digit numbers separated by a 
dash or a 3-digit and a 5-digit number separated by a 
dash. A 9-digit transit-routing field is permitted if 
the 1255 is equipped with the Dash Symbol Trans- 
mission feature 



Process Control is a variable-length field of from to 
15 digits located to the left of the amount field. It 
must be followed on the left by the on-us ( «• ) 
symbol. (See note.) 



Serial Number is a variable field of 10 or fewer digits. 
The field must be enclosed by on-us ( u* ) symbols. 



Account-Number can be a fixed-length field of 5 to 
10 digits, or a variable-length field of 15 or fewer 
digits. The account number field must follow the first 
on-us symbol and contain, to the left of the field, the 
on-us or the transit ( C) symbol. (See note.) 
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Documents vary in thickness and outside dimensions. 
Figure 1-5 summarizes document characteristics. 





1255 Model 1,2, or 3 


Width 


2.5 inches (63.5 mm) up to 4.25 inches 




(108 mm) 


Length 


5.75 inches (146 mm) up to 8.88 inches 




(225.6 mm) 


Thickness 


0.003 inch (0.08 mm) up to 0.007 inch 




(0.18 mm) 
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Characters 


45 plus 9 special symbols if the Dash Sym- 




bol Transmission feature is installed 
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Number 




Fields 


5 



Figure 1 5. Document Size Limits and Characteristics 



SUBR08 

SUBR08 is part of the System/32 system control pro- 
gramming and controls processing done by the 1255. The 
subroutine performs the following input/output functions: 

• Read selected information from documents. 

• Check account number for validity (using modulus 
checking). 

• Create an input record for each document read that can 
be used as input to the user's application program. This 
record contains the contents of all fields present in the 
document; the stacker into which the document is to 
be routed; and indicators that tell whether fields in the 
document are valid or invalid, and whether the 
document is a normal, a control, or an EOF document. 

• Sort documents into selected stackers. 



SYSTEM AND STACKER SPECIFICATIONS 

System and stacker specifications tell the subroutine what 
to do. System specifications describe the input record and 
the processing to be done. Stacker specifications define 
which documents are to be routed to specific stackers. 

i lie i liTuri nail w i ui i u ic apc^i i iva uuii^ uci ■■ iCj . 

• Which fields to read 

• How to verify the account number 

• The stackers into which documents are to be routed 

• How the stackers are to be numbered 

• The document count condition 

• The control and end-of-file documents 

The next chapter describes how to complete the system and 
stacker specifications. 

The information from the system and stacker specifications 
is an array that is complied with the source program or 
loaded at execution time. 

During compilation of the RPG 1 1 or assembler program, 
the overlay linkage editor places the subroutine in the 
object program. More detailed information on how this 
array is created is in Chapters 5 and 6. 
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Chapter 2. How to Complete System and Stacker Specifications 



System and stacker specifications describe each job to be 
done by SUBR08. 

Use the Specifications For Magnetic Character Readers 
form, GX21-9101, Figure 2-1. This form may be obtained 
from your IBM representative or local IBM branch office, 
or the form on the following page may be duplicated and 
used. 

All multicolumn entries should be right-justified. For 
example, the entry in columns 3 through 5 may be one, 
two, or three digits long. If the entry is 65, the 5 must be 
placed in column 5 and the 6 must be placed in column 4. 
Column 3 must contain a or be blank. The columns that 
are shaded on the form on the following page are not used. 
If there is an entry in any one of these columns, the 
program ignores it. 
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SYSTEM SPECIFICATION 

The information on the system specification describes the 
fields that will be read, the control documents, valid 
stackers, the end-of-file (EOF) document, and the weight- 
ing factor for modulus checking. 

One system specification is required for each job and it 
must precede all stacker specifications. 



Document Count Condition (Columns 3-6) 



The following example indicates that the machine will stop 
when 90 documents, plus those in transit, have been routed 
to a stacker: 



III 



MsK 



tot, 

ftto«* 



Field Definition 



Field 

1 



Field 
2 



Field 
3 



Field 
5 



6 



:■:»» 



The number entered in columns 3 through 5 (count entry) 
can be from 001 through 999; it indicates the maximum 
number of documents that the machine should route to 
any stacker. 

For example, if the entry is 090, the document count 
condition is met when 90 documents have been routed to 
any stacker. Because there are up to two documents in 
transit at the time the document count condition is met, 
the total number of documents in a given stacker may 
exceed by two the number specified. 

The entry in column 6 (action entry) indicates what should 
be done when the maximum number of documents has 
been routed to a stacker. This entry can be S (stop), 
I (indicate), or A (alternate). 

If one or both of these entries are blank, the entire entry 
is ignored. 



S (Stop) (Column 6) 

When S is indicated in column 6 and the document count 
condition is met, the machine stops; the program issues a 
message to inform the operator that the machine has 
stopped; and the document count condition is reset to 0. 

If there are one or two documents that have been fed but 
not analyzed, they are processed and routed to the appro- 
priate stacker before the machine stops, even if that stacker 
has met the document count condition. Therefore, it is 
possible for a stacker to contain a few more documents 
than indicated in the count subentry. 



/ (Indicate) (Column 6) 

When I is indicated in column 6, and the document count 
is met, the next control document is routed to the stacker 
that met the document count condition, the document 
count is reset to 0, and processing continues. 



Control Document 

The control document separates documents that have been 
routed to stackers. This is the sole function of the control 
document; control documents are not included in the 
stacker document count and modulus checking is not per- 
formed on them. However, the subroutine creates an input 
record for each control document read. Extra control 
documents are routed to the reject stacker. 

Refer to EOF/Control Field Number (Column 48) for more 
information about control documents. 

If a control document is not read immediately after a 
document count condition has been met, the subroutine 
continues to read and route documents until a control 
document is available. Then the control document is routed 
to the stacker that has met the document count condition. 
Thus, the control document in a stacker indicates that at 
least the number of documents specified in columns 3 
through 5 have been routed to that stacker. 

If several stackers meet the document count condition 
before a control document is read, the first control 
document read is routed to the first stacker that met the 
condition; the second control document is routed to the 
second stacker that met the condition, and so forth. Extra 
control documents are routed to the reject stacker. 
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Control document is in 
stacker. 

30 more documents 
routed to stacker. Control 
document is read after 
1 25th document. 

95 documents in stacker. 
Document count condi- 
tion is met. No control 
document is available. 



The subroutine can route control documents into every 
stacker at a certain point in a job and thus separate docu- 
ments into batches. To define this on the specifications, 
enter a 1 in column 5 (columns 3 and 4 are blank or contain 
0) and an I in column 6. Then insert a stack of control 
documents (at least one for each stacker) among the input 
documents at the point where the batch is to be separated. 

The following example indicates that a control document 
should be routed to a stacker when 95 documents have 
been routed to a stacker. 
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The following example indicates that documents not routed 
to specific stackers by the stacker specifications are to be 
routed to stacker until there are 300 documents in the 
stacker, then to stacker 2 until there are 300 documents in 
the stacker, and so forth, until all the documents are read. 
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Fi«kJ Definition 
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Field Definition. (Columns 16-30) 

The field definition entry is divided into five 3-column 
subentries that refer to the five fields that can be contained 
on a document: 

Allowable 
Subentry Field Length 

Name Columns Name in Digits Length 



Field 1 16-18 

Field 2 19-21 

Field 3 22-24 

Field 4 25-27 



Amount 10 or 11 Fixed 

Process 6 or less 1 Variable 
Control 

Account 10 or less 1 Either fixed 
Number or variable 



Transit- 8 2 
Routing 



Fixed 



A (Alternate) (Column 6) 

When A is indicated in column 6, documents that are not 
routed to one of the stackers specified on the stacker 
specifications are routed to every other (alternate) stacker 
(0, 2, and 4). Documents are routed to stacker until the 
document count condition is met, then routed to stacker 2 
until the document count condition is met, and so forth, 
until the document count condition is met in the last 
stacker. The cycle then begins again in stacker and 
continues until all documents are read. 

No stacker specifications are required for alternate stackers, 
but if documents are routed to an alternate stacker, they 
are not counted; therefore, the stacker can contain more 
documents than are indicated in columns 3 through 5 when 
the document count condition occurs. 



Field 5 28-30 



Serial 10 or less Variable 

Numher 



If a modified data format (greater than 10-digit account number or 
greater than 6-digit process control field) is specified, either of the 
fields may be up to 1 5 digits in length. However, the total of both 
fields cannot exceed 16 digits. 

If the Dash Symbol Transmission feature is used, nine digits must 
be allowed. 



The entry in the first column of each subentry indicates 
whether the field is a fixed length (F) on every document 
read or whether the length varies (V) from one document 
to another. 

The entry in the second and third columns indicates the 
length of the fieid. if the iength of the field varies from 
one document to another, these columns must contain the 
maximum length of the field; otherwise, the field can be 
invalid. Special symbols, such as dashes and blanks in a 
field, should not be included as part of the defined length. 
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A dash is to be considered part of the field length for the 
transit-routing fields only when the Dash Symbol Trans- 
mission feature is used. 

If a field is not to be read, the subentry corresponding to 
that field must be blank. If invalid information is placed in 
the columns for a subentry, the subentry is ignored. 

The following example indicates that: 

• The amount field is a 10-digit fixed-length field. 

• The process control field is a variable-length field of 
from one to six digits. 

• The account number field is a 10-digit fixed-length field. 

• The transit-routing field should not be read. 

• The serial number field is a 6-digit fixed-length field. 



I.I 

III 



T&flp 



to at 



i 



FiaW Definition 



KlldvlftlfelF 



M 



Field 
5 



3S 30 » 22 33 



Mil} 



Modified Data Format 

Modified data format is variable for each user program. It 
allows the user to specify the account number greater than 
10 digits (maximum 15) or the process control field greater 
than 6 digits (maximum 15). However, the accumulated 
total of the two fields cannot exceed 16 digits. Modulus 
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cr 

the 10 rightmost digits of the specified fields. 

The following example shows an account number field of 
12 digits and the process control field specified as 2 digits. 

If the process control field on a document has more than two 
digits encoded, as many digits as possible will be returned in 
the formatted record until all available positions are filled. 
The field validity indicator is turned off for field 2 (process 
control) because it is greater than the 2-digit positions 
specified on the system specification sheet. If the account 
number is less than 12 digits on the document, and the field 
is described as variable on the system specification sheet, 
the account number field is right-justified to position 40 
with the unused positions filled with blanks. If the account 
number is specified as fixed length 12, the account number 
field is marked as valid if the 1255 successfully read the 
document (no misreads), and there are exactly 12 char- 
acters on the document. If a field on the document is longer 
than the digit positions specified on the system specification 
sheet, the leftmost digits are truncated and the field validity 
indicator for that field is turned off. 



Account 
Number 



Process 
Control 



29 



40 41 42 43 44 
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Modulus Check (Columns 37-47) 



Weighting Factor (Columns 38-47) 



A practice in business that provides a certain amount of 
protection against clerical, keying, and fraud errors is 
devising numbers that are self-checking. Self-check 
provides a method of verifying a field at the same time it 
is entered. Also, unless the person attempting the fraud 
knows the system, the chance of an invented number 
matching a valid one is minimal. 

The entries in columns 37 through 47 indicate the modulus 
(10 or 11 ) used to verify the account number and the 
weighting factor that is used to compute the self-check 
digit. 

When online with a System/32, a document found to have 
an incorrect account number prevents setting of the account 
number field-validity indicator. 

Modulus 1 1 checks a number up to 10 digits with any 
weighting factor, summing the products and checking for 
an even multiple of 1 1 ; or modulus 1 1 checks a number 
with a fixed weighting factor, summing the products and 
checks for a multiple of 1 1 with a remainder of 4. In 
modulus 10 and 11, the weighting factor of the check digit 
is 1 regardless of its position, and the digit must be other 
than zero. 

In modulus 1 1 with a remainder of 4, the check digit is 
always in the first position and the weighting factor is 
always alternate 1's and 10's with 1 in the first position. 
For example; 10,1,10,1,10,1. 

Figure 2-2 shows how the self-check digit is calculated by 
modulus 10 and modulus 1 1. 

The subroutine calculates a self-check digit and compares it 
to the self-check digit on the document. (Any digit in the 
account number can be the self-check digit.) When the self- 
check digits are not equal, the account number is invalid 
and the account number validity indicator in the input 
record is blank. 



Modulus Number (Column 37) 

When a is indicated in column 37, modulus 10 checking is 
used to verify the account number. When a 1 is indicated 
in column 37, arithmetic modulus 1 1 or geometric modulus 
1 1 with a remainder of zero checking is used to verify the 
account number. If column 37 contains a 4. geometric 
modulus 1 1 with a remainder of 4 is specified. 



The entry in columns 38 through 47 is the weighting factor 
used to generate the self-check digit for modulus checking. 
One number, (0 through 9 for modulus checking 10 or 1 1 ; 
through 10 for geometric modulus 11) must be entered 
for each digit in the account number (right-justified), and 
an X must be entered in the position corresponding to the 
self-check digit. The digit 10 is coded A on the system 
specification sheet. 

For geometric modulus 1 1 with a remainder of 4, the check 
digit position (X) is assigned the value of 1 and is included 
in the multiplying of the account number by the weighting 
factor. However, it is coded as X on the system specification 
sheet (columns 38 through 47). See Figure 2-2 for calculat- 
ing the self-check digits. 

If one of these entries is blank or invalid, modulus checking 
is not performed. 

The first example indicates that modulus 10 checking should 
be performed on a 6-digit account number. The weighting 
factor 21212, and the account number's self-check digit is 
the rightmost digit. 



v- 



ps 



Modulus Check 



Weighting 

Fector 

(Account 

Number) 



I 39 40 41 42 43 44 46 46 47 



T2ffl2« 



Control 

Document 

Contents 



484850 515253545656 57 58 



1 



End-of-File 
Document 
Contents 



5960 616263646556 < 



4 



The second example indicates that geometric modulus 1 1 
with a remainder of 4 should be performed on a 7-digit 
account number. The weighting factor is 1 A1 A1 A and the 
account number self-check digit is the rightmost digit. 



*»,» 



Xffl 



Modulus Cheek 



Weighting 
Fector 
(Account 
Number) 



38 30 40 41 42 43 44 46 46 47 



I/I4I/HI/UM 



Control 

Document 

Contents 



48 50 5t 52 53 54 56 56 57 58 



s 



End-of-File 
Document 

Contents 



5960 516263646668 f 



Note: If column 37 has an entry, columns 38 through 47 
must contain a valid entry. 
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Using Modulus 10 To Calculate Self -Check Digit 

The subroutine: 



1 . Multiplies each digit of the account number by 

',-*■* n nr »-npnnn^inn riinit r»f thp *A/pinhtinn fantnr 

ILO liUII Cjpwi lumy %jiyi«- " > -■ >~ - - - ■ 3 ■ ■ -g ■ ■ 

Account number 5 2 5 6 3 

Weighting factor 2 12X12 
10, 2, 0, , 6, 6 



Adds each digit of the products: 

1+0+2+0+6+6=15 

Determines the next number divisible by 10 that 
is higher than the sum computed in step 2. 

From the sum 15, 20 is the next higher 
multiple of 10. 

Subtracts the sum computed in step 2 from the 
number determined by step 3. The difference 
is the self-check digit. 

20-15 = 5 

The number 5 is the self-check digit. 



Using Modulus 1 1 To Calculate Self-Check Digit 

The subroutine: 

1 . Multiplies each digit of the account number by 
its corresponding digit of the weighting factor. 

Account number 5 2 6 3 2 

Weighting factor 6 5 4 3 2 X 
30,10, 0,18, 6, 

2. Adds the products: 

30+10 + 0+18 + 6 = 64 

3. Determines the next number divisible by 1 1 that 
is higher than the sum computed in step 2. 

From the number 64, 66 is the next higher 
multiple of 1 1. 

4 Subtracts the sum computed in step 2 from the 
number determined by step 3. The difference 
is the self-check digit. 

66 - 64 = 2 

The number 2 is the self-check digit. 



Figure 2-2 (Part 1 of 2). Calculating the Self-Check Digit 



How to Complete System and Stacker Specifications 2-7 



Using Geometric Modulus 11 with a Remainder of Zero 
to Calculate Self -Check Digit 

The subroutine: 

1 . Multiplies each digit of the account number by 
its corresponding digit of the weighting factor. 



Account number 
Weighting factor 



6 3 8 8 2 4 
A 4 3 X 7 



60,12,24, 0,28 

2. Adds the products: 

60+12 + 24 + + 28= 124 

3. Determines the next number divisible by 1 1 
that is higher than the sum computed in step 2. 

From the number 124, the next higher mul- 
tiple of 11 is 132. 

4. Subtracts the sum computed in step 2 from the 
number determined in step 3. The difference is 
the self-check digit. 

Next highest multiple of 1 1 = 132 

Sum of products = 124 

Check digit = 8 

The number 8 is the self-check digit. 



Using Geometric Modulus 11 with a Remainder of Four 
to Calculate Self -Check Digit 

The subroutine: 

1 . Multiplies each digit of the account number by 
its corresponding digit of the weighting factor. 

Account number 5 18 18 18 

Weighting factor 1 A 1 A 1 A X 



5, 10, 8, 10, 8, 10, 8 

Adds the products: 

5 + 10 + 8 + 10 + 8 +10 + 8 = 59 

Divides the sum computed in step 2 by 1 1 . 
There must be a remainder of 4. 

59 -r 1 1 =5 with a remainder of 4 

The number 8 is the self-check digit. 



Figure 2-2 (Part 2 of 2). Calculating the Self-Check Digit 



EOF/Control Field Number (Column 48) 

The entry in column 48 is the number of the field (1-5) 
that will contain the digits (specified in columns 49 
through 58 or 59 through 68) that identify a document as 
an EOF or control document. An entry of a field 
definition 1 through 5 in column 48 is required. 



f.J 

883 



Hlffl 



ram' 

ToB. 



FieW Definition 



3 



T. 



Hga 



29 30 M 32 33343630 



Modulus Check 



Weighting 
Factor 
(Account 
Number) 



30 39 40 41 42 43 44 45 46 47 



12HMI2I* 



J 
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Control Document Contents (Columns 49-58) 

The entry in columns 49 through 58 is the actual digits 
contained in the control field (indicated in column 48) that 
identify the document as a control document. The entry 
must be right-justified. 

If the control field is a fixed-length field, the entry in 
columns 49 through 58 must be the same length as the 
control field. 

For example, if the amount field is defined in columns 16 
through 18 as a six-digit fixed-length field, and is designated 
in column 48 as the control field, the entry in columns 49 
through 58 must also be six digits. 

If the control field is a variable-length field, the entry in 
columns 49 through 58 can be the same length as, or 
shorter than, the control field. 

If columns 49 through 58 are Wank, the subroutine assumes 
that control documents are not being used. 

When the Dash Symbol Transmission feature is used and 
the transit-routing field (field 4) has been specified as 
the control field (a 4 in column 48), the dash must be 
included in the field length and in the contents of the 
actual control digits. 



The following example indicates that the control document 
has eight 9s in the transit-routing field (field 4). 



i 5? 
iaa 



wm 



: :»i«t*:s 

rtmtt 



Field Definition 



FMd 
2 



ripMflflFliflrW 



BpQ 



M »M M 36 M 3 



Modulus Chflcfc 



Weighting 
Factor 
(Account 
Number) 



38 39 40 41 42 43 44 45 46 47 



12I1I2U121XHI 



Control 

Document 

Cofitentt 



49 50 51 52 53 54 SB 68 67 68 



19I9I9190-W19I 



* 



EOF Document Contents (Columns 59-68) 

The end-of-file document tells the program that all 
documents have been read and that the job should be 
ended. Modulus checking is not performed on this 
document, but the subroutine creates an input record for 
each EOF document processed. 

An entry in column 48 indicates the field that contains 
the digits identifying the document as a control document 
(columns 49 through 58) or EOF (columns 59 through 68). 



The entry in columns 59 through 68 is the actual digits 
contained in the control field (indicated in column 48) that 
identify a document as an end-of-file document. Columns 
59 through 68 must have an entry, and it must be right- 
justified. 

If the control field is a fixed-length field, the entry in 
columns 59 through 68 must be the same length as the 
control field (columns 49 through 58). 

If the control field is a variable-length field, the entry in 
columns 59 through 68 can be the same length as, or 
shorter than, the control field. 
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When the Dash Symbol Transmission feature is used and 
the transit-routing field (field 4) has been specified as the 
control field (a 4 in column 48), the dash must be included 
in the field length and in the contents of the actual control 
digits. 

The following example indicates that the EOF document 
has eight 8s in the transit-routing field (field 4) and the 
Dash Symbol Transmission feature specified. 

V- 



Document 
Contents 



49 50 51 52 53 54 66 56 57 Sfl 



End-of-file 
Document 
Content) 



I8flfl8l-BB18B 
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STACKER SPECIFICATIONS 

The information in the stacker specifications identifies the 
stacker to which a document is routed and describes the 
tests that must be performed on the document before it is 
routed to that stacker. 

One or more stacker specifications must be entered for each 
stacker used, unless A is indicated in column 6 of the sys- 
tem specification. In this case, no stacker specifications are 
required for stackers 0, 2, and 4. See A (alternate) (column 
6) of System Specification in this chapter. 

Stacker specifications are processed in the order they are 
entered. 



Stacker Number (Column 4) 



Stacker Code (Column 72) 

The entry in column 72 indicates how the stackers are 
numbered. The entry can be 4, 8, or A. 

Entry Model How 1255 Stackers are Numbered 

4 1or2 0, 1,2, 3, 4, and R 

8 1or2 0,2,4, 6, 8, and R 

A 3 0, 1,2, 3, 4, 5, 6, 7, 8, A, and R 

b 3 Default is A 

The following example indicates that there are six stackers 
numbered 0, 2, 4, 6, 8, and R : 



r 



Document 
Contents 



57 565360 6162636466 66 67 68 



Mm 

Lertgttv 
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The entry in column 4 indicates the stacker to which a 
document is routed if it meets the criteria described in 
columns 5 through 79. This number must be one of the 
numbers of the stackers on the machine being used, which 
is indicated in column 72 of the system specifications. 

For example, if there is an 8 in column 72 of the system 
specification, the entry in column 4 of the stacker specifi- 
cations must be 0, 2, 4, 6, 8, or R. If, for example, 1 is 
specified, the document that caused this specification to 
be chosen is routed to the reject stacker, and the machine 
stops. 

An asterisk (*) in column 4 indicates a continuation line for 
additional field comparison tests (columns 12 through 79). 
A maximum of two continuation lines can be entered on 
the stacker specification sheet, allowing up to 12 field 
comparison tests to be performed. 

Note: The first stacker specification cannot be a continua- 
tion iine. 



Validity or Presence Check (N/P or Blank) Columns 5 
through 9 

The entry in columns 5 through 9 indicates whether the 
specified field must be (P) present and valid or (N) not 
present and valid. If columns 5 through 9 are blank, no 
checking is performed. 

Note: Continuation lines (asterisk in column 4) must not 
have an entry in columns 5 through 9. 
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N (Not Present) 

An N in columns 5 through 9 indicates that the correspond- 
ing field must not be present or valid before further testing 
is done. 



P (Present) 

A P in columns 5 through 9 indicates that the correspond- 
ing field must be present and valid before further testing 
is done. 



If a document meets the specified conditions (columns 5 
through 9), and no field comparison tests are specified, the 
document is routed to the stacker specified; or if specified 
in columns 12 through 79, further testing can be performed 
on the document. 

(If the document does not meet the conditions specified in 
columns 5 through 9, the document is checked against the 
next stacker specification. If there are no other stacker 
specifications, the document is routed to the reject stacker.) 



Field Comparison Tests (Columns 12 through 79) 



Blank 

If column 5, 6, 7, 8, or 9 is blank, the field associated with 
the blank column is not checked. The blank field can be 
present, absent, valid, or invalid. 

The following example indicates that documents are to be 
routed to stacker when fields 1 (amount) and 3 (account 
number) are valid, and field 4 (transit-routing) is invalid or 
missing. The contents of the remaining fields in the docu- 
ment are of no concern. (In this example, field comparison 
tests are not to be done on documents meeting the criteria 
established above.) 
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Notice that all of the conditions specified must be met 
before the document is routed to stacker 0. If documents 
are to be routed to stacker when any one of the condi- 
tions is met (either field 1 or field 3 is valid or field 4 is 
invalid or missing), the following stacker specifications are 
required: 
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The entry in columns 12 through 79 indicates that the spe- 
cified document fields should be compared to the specified 
test characters and, based on the results, documents should 
be routed to the specified stacker. 

The test can determine whether a field is equal to, not equal 
to, greater than, not greater than, less than, or not less than 
the test character. 

The test can also determine whether a variable-length field 
is long enough to permit additional comparison tests to be 
performed. (See Field Length Validity Check in this 
chapter.) 

Up to 12 tests can be performed on one or more fields by 
specifying continuation lines (column 4). Each field can 
contain 10 or fewer digits. 

Tests are performed sequentially. If test 1 is successful, test 
2 is performed, and so forth, until either a test is unsuccess- 
ful or until the last test specified is successfully completed. 

A document is routed to the specified stacker only if aii the 
tests are completed successfully. Testing is complete when: 

• The specified number of tests have been performed 
successfully. 

• The next field number (columns 1 2, 29, 46, 63) entry, 
including continuation line tests, is blank, and all preced- 
ing tests have been completed successfully. 

• A document fails the test. 

If a document does not meet the criteria specified in one of 
the tests, the document is tested against the next stacker 
specification. If there are no other stacker specifications, 
the document is routed to the reject stacker. 
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If a field comparison test is to be performed on the transit- 
routing field and the Dash Symbol Transmission feature is 
used, the dash must be considered in the field length size 
and must be considered as a valid character in the field 
being tested. 

Since spaces or blanks are not counted as character positions 
on documents, a field containing all blanks has a field length 
of 0. The only test that can determine whether a field con- 
tains all blanks is a field length validity check. (See Field 
Length Validity Check in this chapter.) 

Field comparison tests 1, 2, 3, and 4 are in columns 12 
through 28, 29 through 45, 46 through 62, and 63 through 
79 respectively. Each has the same format. Each entry is 
explained in the following section. If continuation lines are 
specified, the field comparison tests are performed sequen- 
tially as they are entered on the stacker specification sheet. 
Test 5 (continuation line 1 test 1) follows test 4, test 6 
follows test 5, and so on. 



Field Number (Column 12, also 29, 46, and 63) 

The entry in column 1 2 is the number of the field that will 
be tested. The entry may be: 

1 — Amount field 

2 — Process control field 

3 - Account number field 

4 — Transit-routing field 

5 - Serial number field 

Up to 12 field tests can be specified. Each field can contain 
10 or fewer digits. 
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If columns 13 and 14 are blank, default is 0. (For field 
length tests, this entry is the length to which the field is 
compared.) 

In the following example the number that is to be tested is 
100. The rightmost digit that will be tested is 0. If this is 
in the third position from the right in the field on the doc- 
ument, the number in columns 13 and 14 will be 02. (The 
rightmost digit in the field is position 0.) 



/ Field 5 / 



Field 4 



Field 3 



/ 



"•13J3E"* i:o; KD-cm7i:||eig otooi.qi' 




Test 1 
and 2 
Digits 



Field Length (Columns Wand 16, also 32 and 33, 49 and 
50, and 66 and 67) 

The entry in columns 15 and 16 indicates the number of 
positions being tested. At least one position must be tested. 
(The entry must be 1 for a field test.) 



Relative Pos. (Columns 13 and 14, also 30 and 31, 47 and 
48, and 64 and 65) 

In the following example, the entries in columns 13 and 14 
indicate the location of the rightmost digit to be tested, and 
that additional testing is to be performed (asterisk in column 
4) on field 5 following field test 4. 



Not - N (Column 17, also 34, 51, and 68) 

The entry in column 17 is used in conjunction with the 
E/L/G entry in column 18 (also 35, 52, 69) to indicate NE 
(not equal), NL (not less than), or NG (not greater than). 

If the column is blank or contains a character other than N, 
the subroutine ignores it. 
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Compare - E/L/G (Column 18, also 35, 52, and 69) 

The entry in column 18 indicates the condition being tested: 

E indicates that the contents of the specified field are 
equal to the value of the test characters. (This is also 
SDecified in field length tests.) 



Field Length Validity Check 

The field comparison tests can be used to determine 
whether a variable-length field is long enough or shorter 
than the length specified to permit additional comparison 
tests to be performed on that field. 

To do this, enter: 



L indicates that the contents of the specified field are 
less than the value of the test characters. 



• The number of the field to be tested in the Field Number 
column 12 (also 29, 46, or 63) 



G indicates that the contents of the specified field are 
greater than the value of the test characters. 

If the column is blank or contains a character other than E, 
L, or G, default is E. 



Test Characters (Columns 19 through 28, also 36 through 
45, 53 through 62, and 70 through 79) 

The entry in columns 19 through 28 indicates the 10 (or 
fewer) test characters against which the specified field will 
be compared to. 

This entry must be blank if the field length will be tested. 
Refer to Field Length Validity Check in this chapter. 

When the Dash Symbol Transmission feature is used and 
the transit-routing field is specified as the test field, the 
dash must be considered a valid character in the field. For 
example, to indicate transit-routing field 0912-0069 in test 
1, a dash must be placed in column 24 of the stacker speci- 
fications as shown below: 
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Figure 2-3 is an example of a stacker specification that 
routes documents to stackers 1, 2, and 3. 



A 1 in Field Length column 16 (also 33, 50, or 67) 

Nothing in column 17 (also column 34, 51, and 68) 
checks for a length equal to or greater than the length 
specified (an N in these columns checks for a length 
less than the length specified) 

An E in Compare column 18 (also 35, 52, or 69) 

Nothing in the Test Character columns 19 through 28 
(also 36 through 45, 53 through 62, and 70 through 79 



See Figure 2-4 for an example of Field Length Validity 
check. 

If the field is at least as long as the length specified in 
columns 13 and 14 (also 30 and 31, 47 and 48, or 64 and 
65), the test is satisfied and further tests on that stacker 
specification are performed. If the field is not long enough, 
the test is not satisfied and the document is tested against 
the next stacker specification. 



Example of Field Length Validity Check. Test 3 in the 
field comparison area of Figure 24 shows the test for a 
field containing all blanks. Note that column 8 can either 
be blank (as in the example) or contain an N. 

Figure 2-4 also shows the use of field comparison tests to 
check the serial number of a document. All documents 
with a serial number whose last five digits are less than 
33333 are routed to stacker 2. 
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Sequence 
Number 

02 



03 



04 




Vtltdrty or 

Prettnc* 

Ctwdc 



MJ1 
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•»•? 
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Characters 



19 30 2t 22 23 24 25 28 27 2B 

3 & <ittj»j0W9|9 | 9|9|9 



55555555 



5555 



This specification determines whether a document has an amount field of $1000.00 or greater. If so, 
the document is routed to stacker 1 {columns 3 and 4). If not, the document is tested against the 
stacker specification identified by sequence number 03. 

Before the amount field is tested, the document is checked to determine whether it contains both a 
valid amount field and a valid account number (designated by P in columns 5 and 7). 

The test against the contents of the amount field is designated by columns 1 2 through 28. Column 1 2 
indicates that field 1 (the amount field) is to be tested. The first character to be tested is at relative 
position (column 14), which is the rightmost position of the field. Ten characters are to be tested 
(columns 15 and 16). The test is to determine whether the amount is greater than (column 18) $999.99 
(columns 19 through 28). 

This specification determines whether a document has an account number less than 55555555. If so, 
the document is routed to stacker 2 (columns 3 and 4). If not, the document is tested against the stacker 
specification identified by sequence number 04. As a result of stacker specification 02, documents with 
an amount field of $1000.00 or greater would have already been routed to stacker 1 . 

Before the account number is tested, the document is checked to determine whether it contains both a 
valid amount field and a valid account number (designated by P in columns 5 and 7). 

The test against the contents of the account number field is designated by columns 12 through 28. 

Column 12 indicates that field 3 (thp arrount numhor fia\r\\ u t^. k p t pr +p^ i"i, e *;*.* „u-_-~4._. »_ i_. 
_ — -- — . — _ , — s — < j — *~. ■.*-.«, i d w ^,e icaitu, i lit i ii 3u ^naracicr iu ue 

tested is at relative position (column 14), which is the rightmost position of the field. Eight characters 

are to be tested (columns 15 and 16). The test is to determine whether the account number is less than 

(column 18) 55555555 (columns 19 through 28). 

This specification determines whether a document has an account number equal to or greater than 
55555555. If so, the document is routed to stacker 3 (columns 3 and 4). 

Before the account number is tested, the document is checked to determine whether it contains both a 
valid amount field and a valid account number (designated by P in columns 5 and 7). 

The test against the contents of the account number field is designated by columns 12 through 28. 
Column 12 indicates that field 3 (the account number field) is to be tested. The first character to be 
tested is at relative position (column 14), which is the rightmost position of the field. Eight characters 
are to be tested (columns 15 and 16). The test is to determine whether the account number is .not less 
than (columns 17 and 18) 55555555 (columns 19 through 28). 



Figure 2-3. Sample Stacker Specifications 
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The system specification for this job has identified the serial 
number field as a variable-length field containing from one 
to six digits. Therefore, to save time in locating the desired 
documents, two preliminary tests are performed before the 
actual test on the five digits of the serial number: 

• Validity or presence checks (columns 5 through 9) are 
performed to ensure that the document contains a valid 
amount field (field 1), a valid process control field (field 
2), a valid account number (field 3), and a valid serial 
number (field 5). 

• A field length validity check test (test 1, columns 12 
through 18) is performed to determine whether the 
serial number field contains at least five digits. 



Validity or 
P i a aan ca 
Chat* 
IN of P) 



Characters 



19 20 2t 32 23 24 28 28 27 28 



PRffl 



Rtld Comparison Ttstt 



Tmt 
Charact«rt 



36 37 38 » 40 41 42 43 44 45 



3I313I3134 



T«* 
Chantttari 



S3 53 64 58 SB ST 31 M 60 8162 



TO 



Figure 2-4. Field Length Validity Check 

If test 1 indicates that the field is less than five digits long, 
the document is routed to the reject stacker (because there 
are no more stacker specifications). 

If test 1 indicates that the serial number has five or more 
digits, comparison test 2 is performed. 

Comparison test 2 determines whether the document con- 
tains a serial number whose last five digits are less than 
33333; that is, the serial number is between 00000 and 
33332. If the document contains such a serial number, it 
is routed to stacker 2 provided it meets test 3. If it does 
not contain such a serial number, it is routed to the reject : 
stacker (because there are no more stacker specifications). 
Refer to A (Alternate) (Column 4) under Document 
Count Condition (Columns 1 through 4). 

Comparison Test 3 is a field length test. If field 4 is 

not blank the document is routed to the reject stacker (R) 
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SUMMARY CHART OF SYSTEM SPECIFICATION ENTRIES 



System Specification 



Column 



3-5 



16-30 



37 



38-47 



48 



Descriptive Name 



Document Count 



Action 



Field Definition 



Modulus Number 



Weighting Factor 



EOF/Control Field 



49-58 


Control Document 




Contents 


59-68 


End-of-File Document 




Contents 


72 


Stacker Code 



Entries/Explanation 



One to three digits denote the number of document to be routed to a 
stacker before the document count condition is met. 

The action to be performed after the document count condition is met 
for a stacker is: 

S - Stop the 1255. 

I - Indicate document count condition by means of control 

documents, 
A — Alternate stackers. 

Five 3-column subentries describe the fields to be read from a document. 

The first column of each subentry must contain either: 

F - Field is fixed length. 
V - Field is variable length. 

The second and third columns of each subentry must contain a number 
designating the length of a fixed-length field, or the maximum length of a 
variable-length field. 

or 1 designates the modulus checking (10 or 11) used in verifying 

account number: 

— Modulus 10 is used. 

1 — Modulus 11 is used. 

This weighting factor of 10 or fewer characters is used in generating the 
self-check digit for modulus checking. A character ma w be an" diqit from 
through 9, or the letter X. 

A number from 1 through 5 identifies the field used to define end-of-file 
and control documents. 

These numbers in a field identify a control document. 



These numbers in a field identify an end-of-file document. 



A number designates how stackers numbered on the 1255 are being used: 

4 - Six stackers numbered 0.1.2. 3. 4. and R. 
8 - Six stackers numbered 0, 2, 4, 6, 8, and R. 
A - 1 2 stackers numbered 0, 1 , 2, 3, 4, 5, 6, 7, 8, 9, A, and R. 
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SUMMARY CHART OF STACKER SPECIFICATION ENTRIES 



Stacker Specification 



Column 



5-9 



12-28 

12 
13-14 

15-16 
17 

18 



19-28 



29-79 



Descriptive Name 



Stacker Number or 
Continuation Line 



Validity or 
Presence Check 



Field Test 1 

Field Number 
Relative Position 

Field Length 
Not-N 



/-• n i n 



Test Characters 



Field Tests 2,3,4 



Entries/Explanation 



A number or a letter (A or R) identifies the stacker associated with this 
stacker specification. An asterisk (*) indicates a continuation line for more 
field comparison tests (maximum of two continuation lines). 

P indicates that the field must be present and valid before further process- 
ing is done on the document. 

N indicates that the field must not be present or valid before further 
processing is done on the document. 

ft in columns 5 through 9 indicates that the field is not checked. 

These columns must be \b if column 4 contains an asterisk (*). 

The contents of any field in a document or a digit of any variable-length 
field is tested to determine whether the field is long enough to allow more 
tests to be performed. 

A number from 1 through 5 indicates the number of the field to be tested. 

This number corresponds to the relative location of the rightmost digit to 
be tested or the number of digits needed in a field to satisfy a length test. 

This number designates the number of positions being tested. 

The letter N is used in conjunction with column 18 to indicate that tests 
are to be performed for a not-equal, not-less-than, or a not-greater-than 
condition. 

The type of condition being tested is: 

E - Field contents equal test characters, or a length test is to be 

performed. 
L — Field contents less than test characters. 
G - Field contents greater than test characters. 

Ten or less numeric characters are to be compared with the contents of the 
designated field. Entry must be blank if the length of a field is being tested. 

These entries indicate the same type of information as the entries for 
Field Test 1 . 
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SAMPLE OF A COMPLETED SYSTEM AND STACKER 
SPECIFICATION 

Figure 2-5 contains a set of sample specifications for sorting 
bank documents. The types and formats of input docu- 
ments expected and the stackers to which these documents 
are to be routed are: 





Account 


Stacker 


Type of 


Number 


To Be 


Input Document 


Formats 


Selected 


Regular checking 


xx7-xxx-x 





account checks 


xx8-xxx-x 




Special checking 


xx2-xxx-x 


1 


account checks 


xx3-xxx-x 




Business checks 


xxl-xxx-x 


2 


Special handling 


xxx-07xxxx 


3 


documents 


xxx-08xxxx 




Special handling 


01x-xxx-x 


4 


documents 


02x-xxx-x 
03x-xxx-x 
04x-xxx-x 
05x-xxx-x 
06x-xxx-x 
07x-xxx-x 
08x-xxx-x 




Checks from other banks 




R 


Checks over $25,000 




R 


Documents rejected by 






1255 




R 



Figure 2-6 describes the entries on the system specification 
shown in Figure 2-5. The system specification must precede 
all stacker specifications in the job. 

Figure 2-7 describes the entries on the stacker specification 
shown in Figure 2-5. These specifications define the criteria 
for routing a document to stackers. The stacker specifica- 
tions are processed against a document in the order of their 
sequence numbers. If a document does not satisfy all of the 
conditions on a particular stacker specification, that docu- 
ment is tested against the next stacker specification in the 
sequence. If the document has not satisfied any of the 
conditions on any of the stacker specifications, that docu- 
ment is routed to the reject stacker. 

Refer to System Generation in Chapter 8 for more informa- 
tion on how these specifications are compiled. 



Documents with account 
numbers other than above 
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I 
o 

S 

o 

o 

o 
3 

■a 



CO 

< 



a 

CO 



CO 



c 

<J1 



CO 

■o 



3 
■o 



IBM 



International SuunMt Machinal Corpora ion 

SPECIFICATIONS FOR 
MAGNETIC CHARACTER READERS 



GX21-910I-2 

Printed in U.S.A. 



^. 1255 SAMPLE 



Punching 
Instructions 


Graphic 
















Punch 

















[Sheet j[~ o> J 



Programmer. 



I BM 



System Specification 




w nj. ** w « «' h « w^i; w_« « « m 



rrrrm 1 1 1 1 1 1 1 1 1 1 1 1 1 1 U-l 



I 



Stacker Specifications 



Validity or 
Pretence 
Check 
(NorPJ 



w. 



mm 






Vt 



At\ 



i7 



'.IK 



H 






St 



Field Comparison Tests 



iteil 



3* 



Hi 



iJtfQL 



m$L 



iW£* 



iMMne 



3W9J 



m*** 



3llt 



IS 30 21 22 23 24 26 26 27 28 



&lf>$ 



I 6 



Tea 
Characters 



29 K> 31 32 33 



15P.P 



&1& 



18 



83id 



PilMfg 



lit 



1H£ 



36 37 38 39 40 41 42 43 44 46 



Test 
Characters 



I 



Ten 
Characters 



62 53 54 56 56 57 58 58 60 61 62 



70 71 72 73 74 75 76 77 78 78 



.* r • «> 



. W 

1,11 
I if 



m)*.,!>l «* *> » « » 6J S* » 3t 



TT 



—ft 
CO 



Columns 



3-6 



16-30 



37-47 



48-68 



72 



Meaning 

When 600 documents are routed to any 
stacker, the machine stops. 

The size of the amount, account number, 
and transit-routing fields are as follows: 



Columns Field 



16-18 



20-22 



22-25 



Amount 
(field 1) 



Size 

Fixed length, 
10 positions 



Account Variable length, 

Number 1 through 9 

(field 3) positions 

Transit- Fixed length. 

Routing 1 8 positions 
(field 4) 



Modulus 10 check is performed on a six- 
digit account number. The weighting 
factor is 21212, and the account number's 
self-check digit is the rightmost digit. 

In addition to identifying the account 
number, field 3 is used to identify control 
and end-of-file documents. If field 3 con- 
tains nine 8s, the document is considered 
to be a control document. If field 3 con- 
tains nine 9s, the document is considered 
to be an end-of-file document. 

Stackers are numbered 0, 1 , 2, 3, 4, and 
R. 



rhe Dash Symbol Transmission feature is not present. 



Figure 2-6. Description of Entries on System Specification Example 
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Sequence 
Number 



02 



03 



Purpose 



Route all documents from 
other banks to the reject 
stacker (R in column 4) 



Route all checks for amounts 
greater than $25,000 to the 
reject stacker (R in column 4) 



Conditions to be Satisfied 



04 



Route all regular account 
checks (account number 
format xx7-xxx-x) to 
stacker (00 in columns 
3 and 4) 



1. 
2. 



Validity or Presence Check - Amount field (column 5) and 
transit-routing field (column 8) are present and valid. 

Field Comparison Test 1 - First four positions or transit- 
rouimg Tiem are noi uu iu vuuiumns ^t unuuyii *.";■ \n. i» 
assumed for this example that the Dash Symbol Transmission 
feature is not present.) 



XXXX XXXX 

I I I I Mil 

7654 3210* 



Relative position 



Positions being tested for 0010 

The last digit to be tested occupies the fifth position from the 
right end of the field, or relative position 04 (columns 13 and 
14). Thus, since the field is eight positions long, the first four 
positions from the beginning of it are to be tested. 

Validity or Presence Check - Amount field is present (column 
5). 

Field Comparison Test 1 - Amount field contains a value 
greater than $25,000 (columns 19 through 28). 

This test is made for all 10 positions of the field. If only seven 
positions are tested, the utility program will not be able to 
recognize many of the amount fields greater than $25,000; this 
is because the utility program will not test the eighth, ninth, and 
tenth positions of the field. For example, if only seven 
positions are to be tested, an account field of $625,000.00 will 
be considered to be not greater than $25,000 and will thus 
satisfy the test; the digit 6 in the eighth position will not be 
tested. 

Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 - Fifth position from right in account 
number field contains a 7; this is relative position 04 (coiumns 
13 and 14). 



bXX8 XXXXJ 
i i i i — i i i i 
7 6 54 3210 — 



Relative position 



If satisfied, this test indicates that the check is either a regular 
account check (xx7-xxx-x) or a special handling document 
(xxx-07xxxx). Another test is needed to distinguish between 
the documents. 

Field Comparison Test 2 - Eighth position from right in 
account number does not contain a digit; this is relative position 
07 (columns 13 and 14). 

By design, the eighth position of a special handling document 
contains a digit, but the eighth position of a regular account 
check is blank. If the digit is missing, this test is satisfied. 



Figure 2-7 (Part 1 of 31. Description of Entries on Stacker Specification Example 
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Sequence 
Number 



05 



06 



07 



08 



09 



10 



Purpose 



Route all regular account 
checks (account number format 
xx8-xxx-x) to stacker (00 in 
columns 3 and 4) 

Route special account checks 
(account number format 
xx2-xxx-x) to stacker 1 (01 
in columns 3 and 4) 



Route special account checks 
(account number format 
xx3-xxx-x) to stacker 1 (01 
in columns 3 and 4) 



Route business checks 
(account number format 
xxl-xxx-x) to stacker 2 (02 
in columns 3 and 4) 



Route special handling docu- 
ments (account number format 
xxx-07xxxx) to stacker 3 (03 
in columns 3 and 4) 



Route special handling docu- 
ments (account number format 
xxx-08xxxx) to stacker 3 (03 
in columns 3 and 4) 



Conditions to be Satisfied 



Same conditions as for sequence specification 04, except for condi- 
tion 2. Here the fifth position from right in account number field 
must contain an 8, rather than a 7. 



1. 



2. 



1. 



2. 



1. 



2. 



Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 — Fifth position from right in account 
number field contains a 2; this is relative position 04 (columns 
12 through 28). 

Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 — Fifth position from right in account 
number field contains a 3; this is relative position 04 (columns 
12 through 28). 

Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 — Fifth position from right in account 
number field contains a 1 ; this is relative position Q4 (columns 
12 through 28). 

Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 - Fifth and sixth positions from 
right in account number field contain a 07 (columns 12 through 
28). 

Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

Field Comparison Test 1 - Fifth and sixth positions from 
right in account number field contain a 07 (columns 12 through 
28). 



Figure 2-7 (Part 2 of 3). Description of Entries on Stacker Specification Example 



2-22 



Sequence 
Number 



11 



Purpose 



Route special handling docu- 
ments (account number formats 
Olx-xxx-x, 02x-xxx-x, 
03x-xxx-x, 04x-xxx-x, 
05x-xxx-x, 06x-xxx-x, 
07x-xxx-x, 08x-xxx-x) to 
stacker 4 (04 in columns 
3 and 4) 



Conditions to be Satisfied 



1 . Validity or Presence Check - Amount field (column 5) and 
account number field (column 7) are present. 

2. Field Comparison Test 1 - Sixth and seventh positions from 
right in account number field contain a value greater than 00 
but less than 09 (columns 29 through 45); these positions are 
relative positions 05 and 06. 

This type of specification is called a range check. These 
conditions could have been specified by separate stacker 
specifications that would test the sixth and seventh positions 
for 01 , 02, 03, 04, 05, 06, 07, and 08 respectively. In that 
case, eight separate stacker specifications would be necessary 
to do the same thing done by this one specification. 



Figure 2-7 (Part 3 of 3). Description of Entries on Stacker Specification Example 
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Chapter 3. Operating Procedures and Considerations 



STARTING THE 1255 

To prepare the 1255 to begin processing documents, the 
operator must: 

1. Press POWER ON. 

2. Press the document counter reset tab (if required}. 

3. Turn the FUNCTION switch to ON-LINE. 

4. Press VALIDITY CHECK AND READOUT for only 
those fields specified on the system specification. 

5. Press SELF-CHECKING NUMBER (if required). 

6. Joggle documents and place them in the hopper with 
the MICR-encoded area facing downward. 

7. Press START. The 1255 is ready to read documents 
when SUBR08 issues a read command. 

For more detailed operation information, refer to IBM 
1255 Magnetic Character Reader Component Description, 
GA24-3542. 



Transport 

Offline, documents begin feeding continuously, when the 
operator presses START. 

Documents are loaded face down and to the left side in 
the hopper, with the MICR edge against the backguide. 
A document is fed from the bottom of the stack via a 
separator wheel and aligned in the correct position for 
magnetizing and reading. The gap between documents is 
also set as the documents are being aligned. After align- 
ment, the MICR-encoded ink in the document is passed 
through a magnetic field. Then the document is passed 
over a read head that generates a signal characteristic of 
the printed image. Recognition of the image takes place 
through an electronic analysis of the signal. From the read 
station the document moves to a selector area, where the 
vertical stacker transport moves the document to its desig- 
nated stacker. See the Introduction to the IBM 1255 
Magnetic Character Reader Component Description Manual, 
GA24-3542, for a graphic illustration of the document flow. 



Document 
Counter 
Reset 
Tab 



r\j ncn 
ON 



OFF 



jcmr 



FEED 




TRANS- 
PORT 




STACKER 












INTER- 
LOCK 








STACKER 

COMMAND 























START 




STOP 



SORT FIELD 




VALIDITY CHECK AND READOUT 



AMOUNT 




PROCESS 
CONTROL 




ACCOUNT 
NUMBER 












TRANSIT 
ROUTING 




SERIAL 
NUMBER 



SELF 

CHECKING 

NUMBER 



Models 1 and 2 - 1255 Control Panel 
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Documents continue feeding until: 

• A stacker becomes full (full-stacker stop). 

• STOP is pressed (operator stop). 

• A feed failure or jam occurs (feed-failure or jam stop). 

• The hopper becomes empty (empty -hopper stop). 

• The subroutine takes too long to select a stacker for a 
document (stacker command stop). 

• The subroutine indicates that feeding is to stop. 



Full Stacker Stop 

When the stacker(s) becomes full, the document feeding 
stops and the STACKER light turns on. Documents that 
have left the hopper continue and are stacked. Remove 
documents from the full stacker(s), and press START. The 
STACKER light turns off, and documents are fed and 
sorted again. 



Operator Stop 

When STOP is pressed, document feeding stops, but the 
main motor continues to run until all in-process documents 
are stacked. Press START to resume operation. 



Feed Failure or Jam Stop 

See the procedures in IBM 1255 Magnetic Character Reader 
Component Description, GA24-3542. 



Stacker Command Stop 

The stacker-select command directs, to the specified 
stacker, the document just read. On Model 1, documents 
selected to stackers other than the first must be selected 
within 50 milliseconds of the time the trailing edge of a 
maximum-length document leaves the read station. Docu- 
ments selected to the first pocket must be selected within 
24 milliseconds. On Models 2 and 3 all stacker-select 
commands must be issued within 24 milliseconds. 

When the stacker select command is issued too late to route 
the document to a stacker, the STACKER COMMAND light 
turns on and the 1255 stops feeding documents. When this 
occurs, one or two documents may have been fed into the 
1255 but not yet read. These in-process documents, and 
the documents that caused the stop, are routed to the reject 
stacker. Data from the document that caused the stop is 
included in the input record for the job. Data from in- 
process documents is not included in the input record. 

To resume processing, determine which document caused 
the stop. In-process documents are automatically rejected. 
They are prefixed by the letters AR (auto-reject) on the 
input record. The document that caused the stop precedes 
the in-process document(s) and is prefixed by the number 
of the stacker that it should have gone to. 

An auto-reject occurs for any document that is rejected by 
the reader/sorter. Auto-reject occurs if: 

• A read command has not been issued by the time a 
document reaches the read station. 

• If an over-length document is detected. 

• If a document-SDacina condition exists. 



Empty-Hopper Stop 

When all documents have been fed from the hopper, the 
FEED light turns on and the 1255 stops after all documents 
are stacked. Reload the hopper and press START to 
continue. 



• If a short document is detected. 

After determining which document caused the stop, remove 
it from the reject stacker. The in-process documents are on 
top of the document that caused the stop. Remove them 
and place them in the feed hopper. Place the document 
that caused the stop into the appropriate stacker and press 
START. 

The document count is set back to 0,and the operator must 
respond to the condition. 
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PERFORMANCE CONSIDERATIONS 

The 1255 when attached to the System/32 operates in a 
time independent mode. The RPG II or Assembler source 
program interfaces to the 1255 via SUBR08. Figure 3-1 
indicates approximate throughput rates (±10 percent) 
based on the following system configuration, document 
specifications, and user program parameters. 

• Audit trail record lengths are blocked to maximum. 

• Headings are not printed except for the first page. 

• Only batch totals are printed. 

• Printing is from a 48-character print belt. 

• The documents being read are 6 inches long. 

• The 51 -column feature is not installed. 

• Only one disk file is created. 

• Only the essential document capture functions are 
performed. 



Audit Trail 
Record Length 


Model 1 

155 Ipm Printer 

(dpm) 


Models 2 and 3 
155 Ipm Printer 
(dpm) 


15-16 
17-18 
19-22 
23-26 
27-33 
34-44 
J 45-54 


500 
500 
500 
500 
500 
465 
305 


750 
750 
750 
750 
615 
465 
305 



Ipm-lines per minute 
dpm— documents per minute 

Figure 3-1. Document Throughput for 1255 Models 



When SUBR08 is used for the 1 255, up to 80 stacker 
decisions can be made without causing excessive auto- 
rejects or late stacker commands. 

A stacker decision is defined as a field validity or presence 
test, or a field comparison test, as defined on a stacker 
specification. The limit of 80 decisions does not refer to 
the number of stacker specifications, but rather to the 
number of decisions described by these specifications 
(multiple decisions can be made on a single specification). 

Maintaining the rated speed of the device also depends on 
the amount of printing. If printing is done while docu- 
ments are being read, it may be necessary to print informa- 
tion from more than one document per line. 
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Chapter 4. Error Detection and Checking 



SPECIFICATION ERRORS DETECTED BY THE 
PROGRAM 

System and stacker specifications are checked by the sub- 
routine for errors. If an error is found in a specification, or 
while the system is operating with the 1255 attached, the 
identifying MIC and message are displayed on the display 
screen. 

Only messages pertaining to the attachment of the 1255 
are listed in this manual. Other system messages and 
RPG II program messages are listed in the appropriate 
manual; IBM System/32 Displayed Messages Guide System, 
GC21-7704. 



MESSAGE CODES 

Message identification codes (MICs) indicate incorrect pro- 
gram operation, machine errors or, in some cases, informa- 
tion or instructions. The following messages may be dis- 
played as a result of 1255 intervention. 

Note: Because a number of different specification errors 
can be detected, a Type 2 message is issued following a list 
of all MIC numbers displayed for errors detected. The 
Type 2 message is: 

SCP-4975 DMMI OPTIONS (0 3) ? 

ABOVE ERROR (S) INDICATE SPEC ERROR (S) 

Message 4975 is issued in conjunction with error messages 
4952 through 4967. 

With option 0, the specification entries in error revert to 
the specification default for that entry and the job contin- 
ues. For option 3, refer to the associated MIC number in 
this chapter, make the necessary corrections, and resubmit 
the job. Normally, only service representatives doing diag- 
nostic tests use option 0. 



SCP-4950 READER/SORTER IS STOPPED 

Cause 

Operator: Run time error. This message is issued as 
a result of an error or warning detected during the 
1255 processing run. 

The device is stopped due to one of the following 
conditions: 

— Jam stop 

— Stacker command stop 

— Empty hopper stop 

— Stacker full stop 

— Operator stop 

— Device not ready 

— Device not attached to the system 

Make the necessary corrections and continue. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 2: The job is ended. Any new data created 
up to this point is preserved and the job is 
canceled. 



Option 0: Continue the job. The error condition is ignored. 

Option 2: The job is ended. Any new data created up to this point is preserved and the job is canceled. 

Option 3: The job is canceled. Any new data created by this job is lost. 
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SCP-4951 DOCUMENT COUNT CONDITION 
HAS BEEN MET 

Cause 

Operator: Attention required. This is an informa- 
tional message. A 1255 stacker has met the docu- 
ment count condition. An S (indicating stop) has 
been entered in column 6 of the system specifi- 
cation. A stacker indicated in columns 3 and 4 of 
a stacker specification has met the document 
count condition. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 2: The job is ended. Any new data created 
up to this point is preserved and the job is 
canceled. 



4952 DOC COUNT CONDITION INVALID 

Cause 

Programmer: System specification error. The docu- 
ment count condition (columns 3 through 6) is 
incorrectly specified. Any of the following condi- 
tions may have caused this error: 

- Action entry (column 6) is not S, A, I, or 
blank. 

- Count entry (columns 3 through 5) contains 
invalid digits. 

- Action entry specified with no count entry. 
Both of these entries must be provided or 
both must be omitted. 

- Count entry specified without action entry. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



4953 INVALID FIELD DEF 

Cause 

Programmer: System specification error. An invalid 
entry in columns 16 through 30 of the system 
specification caused this error. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 

4954 INVALID MODULUS CHECK ENTRY 
Cause 

Programmer: System specification error. Either 
columns 37 through 47 of the system specification 
contain invalid entries, or field 3 (columns 22 
through 24 of the system specification) is not 
properly defined. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 
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4955 CONTROL FIELD ENTRY INVALID 



4957 STACKER CODE INVALID 



Cause 

Programmer: System specification error. Columns 
49 through 58 identify a field formatted different- 
ly than that defined by the field definition, or the 
entry contains characters that are not numeric, or 
the entry is a dash if the Dash Symbol Transmis- 
sion feature is used. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 



Cause 

Programmer: System specification error. System 
specification column 72 does not contain a 4, 8, 
A, or blank. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Option 3: The job is canceled. Any new data created 
by this job is lost. 



4956 EOF FIELD ENTRY INVALID 
Cause 

Programmer: System specification error. This error 
is caused by either column 48 or columns 59 
through 68 of the system specification. Column 
48 must contain a number (1 through 5) that 
defines one of the fields specified by the field 
definition entry (columns 16 through 30). 
Columns 59 through 68 can only identify a field 
with the same format as the field defined by the 
field definition entry (columns 16 through 30). 

Recovery 



4958 INVALID STACKER NO. 
Cause 

Programmer: Stacker specification error. Columns 3 
and 4 of a stacker specification are blank, invalid, 
or identify a stacker number that does not coincide 
with the stacker code in column 72 of the system 
specification. Column 4 can contain an asterisk 
(*) if continuation lines are specified. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Option 0: Continue the job. The error condition is ignored. 

Option 2: The job is ended. Any new data created up to this point is preserved and the job is canceled. 

Option 3: The job is canceled. Any new data created by this job is lost. 
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4959 VALIDITY TEST ENTRY INVALID 

Cause 

Programmer: Stacker specification error. A validity 
or presence check entry (columns 5 through 9) of 
a stacker specification does not contain P, N, or 
blank. Columns 5 through 9 must be blank for 
continuation lines (asterisk in column 4). 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



4960 FIELD NO. SUBENTRY INVALID 

Cause 

Programmer: Stacker specification error. The field 
number (columns 12, 29, 46, or 63) of a field 
comparison test entry contains an invalid number. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



4961 INVALID COMPARISON CONDITION 
ENTRY 

Cause 

Programmer: Stacker specification error. The 
compare entry (columns 18, 35, 52, or 69) is 
invalid for a field comparison test on a stacker 
specification entry. The entry must be E, L, G, 
or blank. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



4962 NEGATIVE ENTRY INVALID 
Cause 

Programmer: Stacker specification error. A not 
entry (columns 17, 34, 51, or 68) is invalid for a 
field comparison test on a stacker specification 
entry. The entry must be IM or blank. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 

4963 FIELD LENGTH SUBENTRY INVALID 
Cause 

Programmer: Stacker specification error. The field 
length entry (columns 1 5 and 1 6, 32 and 33, 49 
and 50, or 66 and 67) is invalid for a field com- 
parison test on a stacker specification entry. The 
entry is not a value within the limits defined for 
that field on the system specification. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 

4964 RELATIVE POS SUBENTRY INVALID 
Cause 

Programmer: Stacker specification error. The relative 
position entry (columns 13 and 14, 30 and 31,47 
and 48, or 64 and 65) contains an invalid character. 
The entry must be numeric. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 
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4965 RELPOSPLUSFLD LEN GTFLD LEN 
DEF 

Cause 

Programmer: Stacker specification error. The sum 
of the relative position and field length entries on 
a stacker specification is greater than the length 
defined on the system specification for the field to 
be tested. As a result, the field comparison test 
entry indicates that a test is to be done on a char- 
acter that is not within the field to be tested. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



4966 FLD LEN SUBENTNE TEST CHAR LEN 

Cause 

Programmer: Stacker specification error. The field 
length entry (columns 15 and 16, 32 and 33, 49 
and 50, 66 and 67) specified in a stacker specifi- 
cation entry for a field comparison test does not 
equal the number of test characters designated in 
the test characters entry. 



4967 TEST CH ARACTE RS I N VALI D 

Cause 

Programmer: Stacker specification error. The test 
characters entry (columns 19 through 28, 36 
through 45, 53 through 62, 70 through 79) for 
a fieid comparison test on a stacker specification 
contains a character that is not a numeral or a dash 
(dash is valid in field 4 only). 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



SCP-4968 INCORRECT RECORD LENGTH 

Cause 

Programmer: File description specification error. 
Record length (columns 24 through 27) of the file 
description specification must be 0055 or I6I655. 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Recovery 

Option 0: Continue the job. The error condition is 

innnroH 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



SCP-4969 INCORRECT BLOCK LENGTH 

Cause 

Programmer: File description specification error. 
Block length (columns 20 through 23) of the file 
description specification must be greater than, or 
equal to, 550 but not greater than 4070. The 
entry must be a multiple of 55. 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Option 0: Continue the job. The error condition is ignored. 

Option 2: The job is ended. Any new data created up to this point is preserved and the job is canceled. 

Option 3: The job is canceled. Any new data created by this job is lost. 
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SCP-4970 INSUFFICIENT MAIN STORAGE 
TO RUN JOB 



SCP-4977 INSUFFICIENT CONTROLLER 
STORAGE 



Cause 

Programmer: Control specification error. There is 
insufficient main storage at execution time. At 
least 2-1/2K of main storage must be available 
between the last main storage address of SUBR08 
and the program level end address (NPEND) in the 
system communication area (SCA). 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



SCP-4971 1255 CONTROLLER ERROR 



Cause 



Programmer: Stacker specifications in this applica- 
tion program exceeds the maximum controller 
storage size. The program must be recompiled 
with fewer stacker specifications. 

Note: The maximum number of stacker specifi- 
cations is limited to approximately 80 decisions, 

ql+hrtiirth mr\ro than nno Hor"icir*n ran hp inrhjrlpH 

on each stacker specification line. 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



Cause 

Operator: Hardware error. Either a controller mal- 
function, or a microcode diagnostic failing to 
run successfully caused this terminal hardware 
error. Contact your local service representative. 

Recovery 

Option 2: The job is ended. Any new data created up 
to this point is preserved and the job is canceled. 



SCP-4972 INQUIRY REQUESTED 

Cause 

Operator: The inquiry key was pressed while the 
1255 was running. 

Recovery 

Option 0: Continue the job. The error condition is 
ignored. 

Option 2: The job is ended. Any new data created 
up to this point is preserved and the job is 
canceled. 



SCP-4978 UNABLE TO LOAD 1255 

DIAGNOSTIC MICROCODE 

Cause 

Programmer: The attachment controller is unable to 
retrieve the 1255 diagnostic microcode. Contact 
your IBM service representative. 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 



SCP-4979 UNABLE TO LOAD 1255 RUN 
MICROCODE 

Cause 

Programmer: The attachment controller is unable to 
retrieve the 1255 run microcode. Contact your 
IBM service representative. 

Recovery 

Option 3: The job is canceled. Any new data created 
by this job is lost. 
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Chapter 5. Considerations for Writing an RPG II Program That Contains SUBR08 



SUBR08 is part of the system control programming for the 
System/32, System and stacker specifications become part 
of these subroutines by means of an array, associated with 
the SPECIAL device name by a continuation card that 
follows the file description specifications. (Refer to the 
IBM System/32 RPG II Reference Manual, SC21-7595, for 
more information about SPECIAL.) 

Each column in the system and stacker specifications 
represents a 1-byte entry in the array. Therefore, the 
format of the array is also 80 bytes and is in the same 
format as the system and stacker specifications. 

The array can be loaded at compile time or at execution 
time. It must never be referenced by the RPG II program. 
Such references are not diagnosed by the RPG 1 1 compiler. 

The following is a description of the information that is 
unique to writing a program that contains SUBR08. 
Examples and detailed information on how to complete the 
other parts of the specifications are in the IBM System/32 
RPG II Reference Manual, SC21-7595. The reader should 
be familiar with the information in that manual before 
reading this chapter. 



The following entries are required on the first file 

HpCprintinn cnorif i^atinn c+a+oman+" 



Columns 


Entry 


6 


F 


7-14 


Valid RPG II filename 


15 


I 


16 


P, S, or D 


17 


Blank or E if P or S specified in column 16 


18 


Blank, A, or D 


19 


F 


20-23 


Buffer size must be a multiple of 55 



(minimum of 550 and a maximum of 
4070). The larger the buffer size, the 
less chance of the 1255 disengaging. This 
entry determines the document storage 
size 



CONTROL CARD SPECIFICATIONS COLUMNS 12-14 

Approximately 1,000 bytes of main storage in addition to 
the I/O buffer areas must be available for the subroutine. 
I/O buffer areas are described on the file description 
specifications as record length and block length. 



FILE DESCRIPTION SPECIFICATIONS 

Two file description statements specify information that is 
required to interface with the 1255. The first describes 
the file to be read, and the second describes the continu- 
ation statement that describes the array containing system 
and stacker specifications. 



24-27 


0055 of bK 55 (record length) 


28-39 


Blank 


40-46 


SPECIAL 


47-53 


Blank 


54-59 


SUBR08 


60-70 


Blank 


71-72 


Blank or U1-U8 


73-74 


Blank 


75-80 


Program identification 
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The following entries are required for the second file 
description specification to describe the continuation 
statement. 



EXTENSION SPECIFICATIONS 

Extension specifications describe the array. The following 
entries are reauired on the extension soecification sheet: 



Columns 


Entry 








Columns 


Entry 


6 


F 








6 


E 


7-52 


Blank 








7-10 


Blank 


53 


K 








11-18 


Blank, or filename if this is a pre- 


54-59 


Valida 


rray 


name associated 


with the 1255 




execution time array 


60-74 


Blank 








19-26 
27-32 
33-35 
36-39 


Blank 

Valid array name 

80 (this is the number of entries per record) 

Number of entries per array. This entry 



40-42 
43-74 



must be 80 times the number of system 
and stacker specifications for the job 

Length of entry. Must be 001 or W\ 

Blank 
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iNPUT RECORD FORMAT 

The input record is a fixed format, no matter which fields 
of the document are specified to be read. The amount 
field is always positions 45 through 55, the transit-routing 
field is always positions 20 through 28, and so forth. 
Refer to Figure 5-1 for the format and contents of the 
input record, as seen by the application program. 

Note: See Modified Data Format for the variations in 
account number and process control field size when the 
modified data format is specified. 



Positions 



Stacker 



Blank 



Type 



Field 

Validity 

Indicators 

— f *— 

5 9 



Serial 
Number 

10 19 



Transit- 
Routing 

-ir— 



20 



28 



Account 
Number 

— n — 

29 38 



Process 
Control 

— n — 

39 44 



Amount 

— + S 

45 55 



Position 


Contents 


1-2 


A number or a letter that identifies the stacker into which the document was routed, or one of the 




following error indicators: 




AR — The document was autorejected by the device. 




PR — A parity error occurred when this document was transmittted from the device. 




If one of these error indicators appears here, the remainder of positions 3 through 55 of the input 




record for this document is blank. 


3 


Blank 


4 


Document type code, set as follows: 




P — Normal document. 




C - Control document. 




E — EOF document. 




I — Control document that caused the indicate condition to be met (I is 




entered in column 6 of the system specification.) 




A — MICR document that caused the alternate condition to be met. (A is entered 




in column 6 of the system specification.) 




S — MICR document that caused the stop condition to be met. (S is entered 




in column 6 of the system specification.) 


5 


Serial number (field 5) validity indicator, set as follows: 




5 — The field was read and is valid. 




Blank — The field is not present or is invalid. 



Figure 5-1 (Part 1 of 2). Format and Contents of the Input Record as Seen by the Application Program 
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Positions 



Stacker 



Blank 



Type 



Field 

Validity 

Indicators 

— SH — 



9 



Serial 
Number 

— <,s — 

10 19 



Transit- 
Routing 

— 5J— 

20 



28 



Account 
Number 



29 



+ <r 



38 



Process 
Control 



39 



-n- 



44 



Amount 



45 



•u- 



55 



Position 


Contents 


6 


Transit-routing (field 4) validity indicator, set as follows: 

4 — The field was read and is valid. 
Blank — The field is not present or is invalid. 




^ 


Account number (field 3) validity indicator, set as follows: 

3 — The field was read and is valid. 
Blank — The field is not present or is invalid. 




8 


Process control (field 2) validity indicator, set as follows: 






2 — The field was read and is valid, or the field was miss 


ng and the account number and 




amount field are present. 






Blank — The field is invalid, or either or both the account number and amount fields 




are not present. 




9 


Amount (field 1) validity indicator, set as follows: 

1 - The field was read and is valid. 
Blank - The field is not present or is invalid. 


Blanks will occupy the unused 
portion of these fields when the 
fields are shorter than the maximum 


10-19 


The serial number from the document, right-justified. J 


allowable length. If the field is not 
read, its corresponding entry in the 


20-28 


The transit-routing field from the document, right-justified. I 


input record is blank. 


29-38 


The account number from the document, right-justified. \ 


If modified data format is specified, . 
the account number field (positions 


39-44 


The process control field from the document, right-justified. 1 


29 through 38) or the process con- 
trol field (positions 39 through 44) 


45-55 


The amount field from the document, right-justified. 1 


may have up to 15 digits in either 
of the fields. However, the accumu- 
lated total of both fields cannot 
exceed 16 digits. 



Figure 5-1 (Part 2 of 2). Format and Contents of the Input Record as Seen by the Application Program 



5-4 



Examples 

Following are examples of two RPG II programs using 
SUBR08. These programs show the necessary fields to 
code on the RPG II specification sheets and the entries 
for the 1255 system and stacker specifications. 



Program 1 (Sample 1) 

SAMPL1 (Figure 5-2) reads five fields, routes all valid 
documents read, totals the amount fields, totals the number 
of documents, and rejects all documents that have fields 
1, 3, or 4 invalid. The Control Card Specification entry 
(columns 12 through 14) describes the size of storage 
required to execute this program. MICR is the name of the 
input file as described on line 2 of the file description 
specification sheet. Line 3 describes the compile time 
array called ARRAY. PRINT is the name of the output file 
for this program. 



Extension specifications further describe the compile time 
array. Columns 33 through 35 must contain 80. Columns 
36 through 39 must be 80 times the number of stacker 
specifications, and columns 40 through 42 must be 1. 
The input specification sheet indicates the filename and 
describes the format of the input document. See Figure 5-1 
for the format and relation of the input specification sheet 



CIIIMC3 LU II IC lll|JUl ICI.UIU. 



■ u€ caicuidtion anu output 



specification sheet entries are common RPG II entries. 
Refer to the IBM System/32 RPG II Reference Manual, 
SC2 1-7595, for a description of the specification sheet 
entries. 

The system and stacker specifications describe the entries 
used to create the compile time array named ARRAY. 
Refer to Chapter 2 for a description of the entries for 
these specifications. 
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Data 


Punch 




















Control Card Specifications 
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Size to 
Compile 

7 8 9 




6 

o 

10 


Q. 
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Size to 
Execute 

12 13 14 


I 

15 


1 

in 
5 

16 


17 18 


1 

O 
19 


D 
20 
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21 


% 
§ 

o 

CO 
22 


Numbe 
Of Prin 
Position 

23 24 2 


I 

s 
< 

5 26 


Model 20 
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i i 

16 37 


Moue 
20 


c 

40 


I ? 

S = 
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= 3 
5 2 

1 42 


1 

J? 

43 <J 
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L. ° 
5 C 
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E i 

14 45 


46 




1- 

47 
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1 
48 


49 
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§ 

50 


O 
O 

cc 
o 

or 

51 


Refer to the specific System Reference Library manual for actual entries. 
52 53 54 55 56 57 58 59 BO 61 62 63 64 65 66 67 68 69 70 71 72 73 74 
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File Description Specification 
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Filename 
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vlode of Processing 
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39 


Device 

40 41 42 43 44 45 46 


Symbolic 
Device 
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Name of 
Label Exit 


Extent Exit 
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File Addition/Unordered 




r 




Q 
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15 




File Designation 


28 


Length of Key Field or 


< 


Number of Tracks 


Line 

3 4 5 


1 
E 

6 


D 

t 

y 

16 




End of File 








for Cylinder Overflow 


17 


^ 


29 30 




Record Address Type 




Number of Extents 






XL 

1 

31 


Type of File 
Organization 


Storage Index 






Q 
< 

18 




File Format 




Tape 
Rewind 


Q 
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> 

13 


Block 

Length 
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Record 
Length 
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File 

Condition 
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Figure 5-2 (Part 1 of 6). RPG II Programming Using SUBR08 (SAMPL1) 
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Line Counter Specifications 
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Program 2 (SAMPL2) 

SAMPL2 (Figure 5-3) reads documents from the 1255 and 
directs them to stacker number 2 if the amount field is 
greater than $99,999.99. All documents with field 
1, 3, or 4 invalid are rejected. All valid documents are 
directed to stacker 0. 

The transit-routing, account number, and amount field are 
printed. Each print line contains data from four input 
documents. Each batch control document is directed to 
the reject stacker and causes a batch total to be printed. 
All valid documents are written to the disk file called 
DISKOUT. 

The following assumptions apply to this program: 

• A batch control document follows each batch, including 
the last batch preceding the end-of-file document. 

• A 1255 Model 1 is the device attached to the system. 

• The Dash Symbol Transmission feature is on the 1255. 

MICR is the name of the input file using the RPG II 
SPECIAL device. Output is to the printer file PRINT for 
batch totals and to the disk file DISKOUT for all valid 
documents. The extension specification sheet describes 
the array and the array fields that are to be printed. 

Refer to the IBM System/32 RPG II Reference Manual, 
SC21-7595, for a description of the entries for the input, 
calculation, and output specification sheets. The system 
and stacker specifications define the fields and specify the 
tests to be performed on each document. 
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Chapter 6. Coding Necessary to Write an Assembler Language Program Containing SUBR08 



You should be familiar with the information in the IBM 
System/32 Basic Assembler and Macro Processor Reference 
Manual, SC21-7673, before reading this sample program. 

The following code illustrates the techniques required to 
use SUBR08 in an assembler language program: 

START 



EXTRN SUBR08 



********************** ************************** ************** 

* MAKE A READ REQUEST TO THE 1255 ROUTINE - SUBR08 * 
************************************************************** 

LA DTF,XR2 1255 DTF 

MVI 15( ,XR2) ,X'80' READ REQUEST 

B SUBR08 REQUEST A RECORD 



************************************************************** 

* TEST COMPLETION CODE RETURNED FROM SUBR08 * 

************************************************************** 

CLI 14(,XR2),X»40' TEST FOR SUCCESSFUL READ 

BE PR100 GO PROCESS RECORD 

CLI 14(fXR2),X«42' TEST FOR END OF FILE 

BE ENDOJ GO CLOSE FILES 



************************************************************** 

* PROCESS THE RECORD RECEIVED FROM THE 1255 ROUTINE * 
************************************************************** 

PR100 EQU * 

L 13(,XR2),XR1 LOAD ADDRESS OF THE INPUT RECORD 



************************************************************* 

* END OF JOB - CLOSE 1255 FILE * 

************************************************************* 

ENDOJ EQU * 

LA DTF,XR2 1255 DTF 

MVI 15( ,XR2),X'10' CLOSE REQUEST 

B SUBR08 GO CLOSE FILE 
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IBM System/32 Basic Assembler Coding Form 



PRCKiRAM KEYING GRAPHIC PAG£ J. OF Y 


PROdRAMMER | DATE INSTRUCTIONS CHARACTER CARD ELECTRO NUMBER 
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Chapter 7. 1255 Functions 



This chapter is intended for persons interested in the opera- 
tion and characteristics at the machine code level of the 
IBM System/32 with a 1255 attached. Included are the 
instructions, formats, and 1255 check conditions required 
for interfacing with the IBM 1255 Magnetic Character 
Reader. See the IBM System/32 Functions Reference 
Manual, GA21-9176, for a complete description and 
explanation of all functional characteristics of the 
System/32. 

An array is built from information entered on the system 
and stacker specification sheets. The system specifications 
describe the fields that are to be read: the control doc- 
ument, valid stackers, the EOF document, and the weighting 
factor for modulus check. 

The stacker specification identifies the stacker to which a 
document is routed and describes the tests to be performed 
on the document before it is routed to that stacker. See 
Chapter 9 for a description of the column entries in the 
system and stacker specification sheets. 

Note: When coding is done at the microcode level to inter- 
face with a 1255, the data management module specified 
must not allow inquiry when the 1 255 lOBs are active. 
Inquiry must wait until the 1 255 is stopped or unpredict- 
able results can occur. When inquiry is acted upon, only 
the or 2 option is allowed. 



INSTRUCTION FORMATS 

Instruction formats are distinguished by their ability to 
address storage. The length of each instruction is deter- 
mined by the type of addressing being performed. All 
instruction formats have two elements in common: the 
op code and the Q code. Each element is one byte long. 
The op code determines the type of addressing (thereby 
the length of the instruction) and the operation to be per- 
formed. The function of the Q code is determined by the 
instruction and therefore, is discussed with each individual 
instruction. 

The following instructions are required for interfacing 
System/32 with the 1255 Magnetic Character Reader. 
See Chapter 1 2 for the format of the 1 255 IOB. 
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START MAGNETIC CHARACTER READER IOB 



Op Code 

(hex) 


Q Byte 1 
(hex) 


R Byte 2 
(hex) 


Byte 1 


Byte 2 


Byte 3 


F3 


50 


XX 


Address within the system queue header table for the 
1255 IOB is hex 508. The Q code for loading the 1255 
IOCH (input/output control handler) control storage 
transient is 02; the Q code for loading the 1255 
diagnostic control storage transient is 03. 

2 

00 specifies a normal SIO request. 01 indicates a 
specification to reset a 1 255 error and continue 
processing lOBs. FF is a request to disable the 1 255. 



Program Note 

If the Q code is hex 51 (get document request) or hex 53 
(get single document request), the IOB, after it has been 
processed, is dequeued and the next IOB is processed, if 
there are any on the chain. 



Resulting Program Status Byte Settings 

This instruction does not affect the program status register. 



Operation 

This instruction starts the operation specified by the 
Magnetic Character Reader IOB. When the operation is 
complete, the system branches back to the next sequential 
instruction of the program. 

The start I/O instructions are invoked in the following 
sequential steps: 





QCode 


R Code 


Sequence 


(hex) 


(hex) 


Load diagnostic code 


52 


Note 1 


Load microcode 


54 


Note 1 


Load compressed specifications 


56 


00 


Load work area 


56 


02 



bet document request (note 2) 



51 



Note 3 



Notes: 

1 . The R code represents the actual number (in hex) 
of sectors of code on disk. 

2. At completion of a get document request (IOB 

Q code = hex 51) the lOBs must be chained on the 
queue. 

3. The R code represents the number of documents 
required to complete the input area associated with 
this IOB (the input area associated with this IOB 
divided by 55). 
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INITIALIZE MAGNETIC CHARACTER READER 



Op-Code 1 
(hex) 


Q Byte 1 
(hex) 


Operand 1 Address 1 
(hex) 


Control Code 2 
(hex) 


Bytel 


Byte 2 


Byte 3 


Byte 4 


Byte 5 


Byte 6 


Byte 7 


Byte 8 


CO 


87 


00 


04 


OF 


00 


xx 


00 


1 The op code, Q byte, and operand address specify a branch to a general entry location in control storage. 
2 The control code is also called a request indicator byte (RIB); it specifies the system operation. 02 in byte 7 specifies loading 
1 255 IOCH microcode control storage transient; 03 specifies loading 1 255 diagnostic control storage transient. 



Operation 

This instruction establishes the system control codes needed 
for the 1255 device operations. When the initialize opera- 
tion is complete, the system branches back to the next 
sequential instruction of the program. 



Program Note 

The program must issue this instruction once per interface 
with the 1255. 



Resulting Program Status Byte Settings 

This instruction does not affect the program status register. 
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QUEUE/DEQUEUE MAGNETIC CHARACTER READER 



Op Code 1 
(hex) 


Q Byte 1 
(hex) 


Operand 1 Address 1 
(hex) 


Control Code 2 
(hex) 


Byte 1 


Byte 2 


Byte 3 


Byte 4 


Byte 5 


Byte 6 


Byte 7 


Byte 8 


CO 


87 


00 


04 


0E 


xx 3 


10 4 


00 


^The op code, Q byte, and operand address specify a branch to a general entry location in control storage. 
^The control code is also called a request indicator byte (RIB); it specifies the system operation. 
Byte 6 (in control code) specifies what the system does with the 1255 IOB: 

00 loads the IOB in the last position on the system IOB queue. 
10 loads the IOB in the first position in the system IOB queue. 

01 removes the IOB from the system IOB queue. 
Byte 7 specifies the Q-header displacement. 



Operation 

This instruction loads the 1255 IOB into the system IOB 
queue or removes the IOB from the queue as specified in 
byte 6. When the queue/dequeue instruction is complete, 
the system branches back to the next sequential instruction 
of the program. 



Program Note 

XR1 must contain the address of the Magnetic Character 
Reader IOB when the program issues the queue/dequeue 
instruction. 



Resulting Program Status Byte Settings 

This instruction does not affect the program status register. 
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1255 CHECK CONDITIONS AND STATUS 

These bits show the conditions that result after execution, 
or attempted execution, of an operation requested by the 
1255 IOB. 



Bit 




2 
3 



Diagnostic microcode failed when the 1 255 
adapter or the attachment controller diagnostic 
microcode was being diagnosed (Q code 52). 

Document count condition reached for a speci- 
fied stacker. An S (indicating stop) in column 
6 of the system stacker specification caused this 
bit to be set on. 

This bit is not used. 

Attachment controller DBO/DBI parity check 
set when an error occurs during data transfer 
between the 1255 adapter and the attachment 
controller. 

External I/O light set on due to a normal stop 
condition in the 1255 (hopper empty, stacker 
full, or operator stop). 

Attachment controller memory parity check 
caused by a hardware malfunction in the attach- 
ment controller memory. 

Attachment controller long timeout set when 
the attachment controller stops or loops longer 
than 3 seconds. 

Sorter is stopped due to one of the following 
conditions: 

— Jam stop 

— Stacker command stop 

— Empty hopper stop 

— Stacker full stop 

— Operator stop 

— Device not ready 

— Device not attached to the system 



Bytel 

Bit 




4 
5 
6 
7 



Meaning 

Document auto-reject set at end of transmission 
time because a read command had not been 
issued when a document reached the read head, 
a document exceeds iength specifications, a 
short document is encountered, or a document 
spacing condition exists. 

This bit is not used. 

Misread with reject caused when a misread is 
detected on a field that is specified as a field 
test. 

Misread without reject caused when a misread is 
detected on a field that is not specified as a test 
field. 

This bit is not used. 

This bit is not used. 

This bit is not used. 

This bit is not used. 
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Part 2. 1255 Program Logic 



Part 2 includes the following chapters: 

Chapter 8. Introduction to 1255 Program Logic: General 
information about the functions and characteristics of the 
1255 Magnetic Character Reader. 

Chapter 9. Method of Operation: Functional diagrams to 
present the operation of the MICR attachment. References 
to the modules and routines called to perform the functions. 

Chapter 10. Program Organization: The organization of 
each module of the MICR attachment. 

Chapter 1 1. Directory: Routine names, their associated 
diagram number, and functions of the routines. 

Chapter 12. Data Areas: Data areas unique to the MICR 
attachment. See IBM System/32 System Data Areas and 
Diagnostic Aids, SY21-0532, for a description of data areas 
used systemwide. 

Chapter 13. Diagnostic Aids: Diagnostic aids for the 
DUMP facility, nonoverlay mode, trace buffer, and an 
attachment controller dump. For information regarding 
other System/32 diagnostic aids, see IBM System/32 
System Data Areas and Diagnostic Aids, SY21 -0532. 
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Chapter 8. Introduction to 1255 Program Logic 



DIAGRAM TECHNIQUES 

Diagrams in this manual graphically explain the functions of 
the program. These diagrams are structured from general to 
detailed levels; namely, the table of contents, one or more 
overview diagrams, and one or more lower-level diagrams 
for each overview diagram. 



TABLE OF CONTENTS 

The table of contents (diagrams 0.x) shows: 

• The structural relationship of all the diagrams 

• The descriptive title of each diagram 

• The assigned number for each diagram 



OVERVIEW DIAGRAMS 

The input-process-output format is used for both the over- 
view and lower-level diagrams. 

An overview summarizes the functions of a group of related 
lower-level diagrams and is included in the appropriate 
Method of Operation section. Overview diagrams show: 

• Main input items 

• Main output items 

• A brief description of functions; included are references 
to lower-level diagrams for each of the functions 
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LOWER-LEVEL DIAGRAMS 

Lower-level diagrams are included in the appropriate 
Method of Operation section and are arranged to show 
(refer to example below) : 

ffl) Name of each function that passes control to this 
diagram 

Mp Requirements for processing (INPUT) 

Q A sequential listing of PROCESS steps 



Q Results of processing (OUTPUT) 

fcy Name of each function (diagram) that receives control 

{•y Extended description (boxed numbers match those in 
the process area) 

np Module or routine where each step takes place 

(?) Module or routine called to perform a function 




DESCRIPTION 



o 



LAaM^^ /VV ^ a ^ n — 



MODULE/ 



nuu I HMC 



I l/\AA-~^ 



Vmaa/v^-^ 
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Arrows and boxes (in example below) show relationships 
by their positions: 

Q All items in INPUT apply to all numbers in PROCESS. 

K) Item fp applies only to number Q . 

4g) Item Gt applies to any number in PROCESS. 

(Q| Items ^y and ^M apply to number Q . 

^3 Routine ^p is used only in step Q . 

(3) Routine ^p is used in two or more steps in the process 
block. The extended description indicates the steps 
that use the routine. 



LEGEND 



(Diag. # 



Control flow (closed arrows) 

|^> Data flow (open arrows) 

Reference numbers 

Address pointer 

) Diagram number of a routine that is 
called by the process step it appears in. 
If parentheses are located near the exit 
pointer, the called routine pertains to two 
or more steps in the PROCESS block. 



i INPUT I 



© 



.Q. 



1 



„Q. 



Lr 



o 



i PROCESS I 



A*\AM,U*J 
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' © ) 



G 



O 



>i 



yC-M-Kt/J/l-l* 



>! 



AMAJMAAA4 



© 



X O ) 



^1 



I OUTPUT i 



Note that the above drawing is for explanation purposes 
only. 
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USING FUNCTIONAL DIAGRAMS 

You have available three related sources of information as 
shown: 

Functional diagrams 

(Method of Operation, Chapter 9) 




Prologues and code 
(program listings) 



Routine descriptions 

(Program Organization, Chapter 10) 



All three are cross-referenced by means of the diagram 
number and the routine name. 



SUBR08 is included in the object program during link 
editing. Refer to the IBM System/32 RPG II Reference 
Manual, SC21-7595, for information about SPECIAL. 

SUBR08 and its associated modules #MI08 and #MICR are 
functionally identical. #MI08 is an overlay that is fetched 
on top of SUBR08. #MICR is fetched into a 2.5K area 
of storage. This area is rolled out to allow #MICR to be 
fetched. Upon #MICR completion, the area is rolled back 
into main storage. #MICR performs diagnostics on speci- 
fications, builds entries in the COMMON area, and builds 
compressions for the stacker specifications. Figure 8-1 
shows the logic flow for SUBR08. These routines are 
divided into two sections: document processing and 
stacker select. 



Document Processing 

The document processing section passes records, as they are 
requested, to the RPG II or assembler object program. 



You can also find a particular routine in the manual by 
referring to the directory (Chapter 1 1) or the index entry. 



SYSTEM CONFIGURATION 

The 1255 attachment is supported on all models of 
System/32; however, the 1255 cannot operate asynchro- 
nously in a data communication environment. 



Stacker Select 

Based on stacker specifications, the stacker select section 
determines the stacker for each document being read from 
the 1255. 



SYSTEM GENERATION 

The customer interfaces with SUBR08 on System/32 
through either the RPG !! SPECIAL device support or the 
assembler. To achieve maximum throughput on System/32, 
an attachment controller is used to interface with the 1255. 
The attachment controller also handles the stacker select 
and modulus checking routines. The array containing the 
system and stacker specifications is the same as any other 
array, except that it cannot be referenced by the user 
program. 
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Program Overview 



I Start J 



V No 



Application 
program issues 

command request 



SUBR08 



#MI08 



Document 
processing 
section 




Initial 
entry 



Document 
is read 



I 



#MIDMC 



Diagnostic 
microcode 



#MIRMC 



Run 
microcode 



Diagnostic and run microcode 
are loaded by #MI08 into the 
1255 controller on initial entry. 



-MICR 



Scan and 
diagnose 
specifications 

Build 

compression 

groups 

Build common 

area 



#MICR 



Diagnostic 
message 
(if any) 



"I 
I 
I 
I 



Enclosed processes are described in this manual 



Application 
program 
processes 
data 




C End ) 



Figure 8-1. Logic Flow When SUBR08 is Called 
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Chapter 9. Method of Operation 



The 1255 MICR support on System/32 is provided via 
SUBR08, which is the RPG II or assembler interface to the 
1255. The subroutine provides the 1255 device allocation 
and deallocation, buffer management, error handling, and 
the passing of formatted data to the main program. It 
also provides, through the #MICR routine, for the analysis 
and compression of the user-provided system and stacker 
specifications. Control for the stacker select and modulus 
check routines is provided by the attachment controller. 
The following HIPO diagrams show the logic flow of 
SUBR08. 
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Diagram 25.1 . SUBR08 Data Management Overview 



9-2 



I INPUT 



u> 



SPECIAL DTF 




System and stacker _ 
specifications from 
caller 



Disk : 



PROCESS i 



DTF command byte is checked f or a 

close request. If close requested 
lOBs are dequeued, exit to caller. 

tf not first time entry from #WI08, 
exit to diagram 25.1.1.3. 

Check whether record length is equal to 
55; if not, set error flag byte. 

Check whether block length is equal to 
or greater than 550 and equal to or 
less than 4070; if neither, set error 
flag byte. 



> 5. Allocate DTF with device code of hex 52 
6. Check whether enough storage is 



□ 



available to load #MICR. If not, set 
error flag byte. 



Pulh out 2.5K of main storage onto 
disk. 



Load compress routine (#MICBI; then 
exit to diagram 25.2. 



Load MICR diagnostics and microcode 
into control storage, and load controller 
storage (common area is loaded into 
the controller). 

Set IOB Q code to hex 51 (get docu- 
ment request). 



To Diagram 
25.1.1.1 



OUTPUT! 




psyslog MIC 4968 
>Syslog MIC 4969 

^> Syslog MIC 4970 



* Compressed system and 
stacker specifications 



f^> Syslog MICs (type 21 



4952 4953 4954 4955 
4956 4957 4958 4969 
4960 4961 4962 4963 
4964 4965 4966 4970 



£> Syslog MIC 4975 [type 1] 



DESCRIPTION 



3. 

4, 

5. 

6. 

7. 

8. After compression routine is loaded into main storage, exit to diagram 25.2 for system and stacker specifications analysis. 

9 

10. - 



Diagram 25.1.1. #MI08 Data Management Initialization 



MODULE/ 
ROUTINE 



Method of Operation 9-3 



From Diagram 




■PROCESS! 



1. If in nonoverlap mode, the block 

size is set to 165 and the Q code 
for the tOB is set to single cycle. 

> 2. Divide the system I/O block into three 
buffer areas. 



3. An IOB is built for each of the three 
buffer areas. ^HZI^^^Z 



4. 2.5K of storage is pulled from disk to 
main storage. 



J~ 



OUTPUT l 



3 I/O buffers chained 
^ bv pointers 

IOB 1-* — »-IOB2 
IOB 2 ■— «- IOB 3 
IOB3-* — »-IOB 1 

Buffer lOBs (31 



To Diagran- 
25.1.1.2 



Diagram 25.1.1.1. #MI08 Data Management Buffer Initialization 



9^t 



From Oiagrarr 
25.1.1.1 



I INPUT 



=Uf 



lOBs (3! are loaded on queut; and .; 
StO is issued tor each 



From Diagram 
25.1.1.4 



• 2 A watt is issued for th« first IOB 



on the queue to he posted complete. 



^^^OUTPU 



To Diagram 
25.11.3 



Diagram 25.1.1.2. #MI08 Data Management Buffer Management 
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From Diagram 



=Uf 



■PROCESS! 



Check whether the record count (R code) 
in the current IOB is equal to zero 
(buffer is empty); if true, exit to 
diagram 25.1.1.4. 



2. Check for EOF document. If present, 
EOF is indicated in the DTF. 

3. Caller's DTF is updated with the 
address of the current document. 

4. If not an EOF document, the record 
count IR code) is decremented and 
the current record position >% 
updated. 



■ OUTPUT i 



Return to 
Caller 



Diagram 25.1.1.3. #MI08 Data Management Data Control 
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From Diagram 



=lJp 



■ PROCESS! 



The completion code is tested for hex 40 
If equal, continue to step 2 If not ~ 

equal, check sense byte and ewit to 
diagram 25.3. 



<C 



r 

1 I I 



OUTPUT! 



2. The IOB completion code is set to ~ 
hex 00, the record count (R code! is 
reset, the IOB is queued, and an SIO 

is issued for the IOB. 

3. The current IOB pointer is updated 
to point to the next IOB on the chain. 



J 

_> IOB 



To Diagram 
25.1.1.2. Stap 2 



Diagram 25.1.1.4. #MI08 Data Management Error Check and Buffer Management 
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XR2 
I I 
OTF 



U>« 



I 1 — "V System and s 

W^^ tn«r i f ic at i ni* 



From #MI08 
Diagram 



U 



System and stacker 
specifications 



i PROCESS i 



1. Retrieve system specifics tic 



^> 



Scan document count field Determine _ 
document count limit and action. Set - 
error flag if field is invalid. 



Scan field definitions. Determine 

which fields are to be read, which 

fields are fixed or variable and 

the field lengths. 

Add fields to determine total ~~ 

document length. 

Set error flag if any fields 

are invalid. 



Scan modulus check fields for 
modulus 10 or 1 1 or geometric 
modulus 1 1 checking, if not 
present, no modulus check is 
to be performed, 

Verify the weighting factor. 

Set error flag if field is invalid. 



5. Scan control and EOF document contents - 
field. Determine which field is 
specified and verify its contents. 

Set error flag if field is invalid 

6. Scan stacker code field. Verify and 
set error flag if field is invalid. 



OUTPUT! 



System specification 
error flags 



1 



> 



count action 



document length 



control/EOF field 
number 



- modulus check 
indicator 



- modulus check 
weighting factor 



-s^ - control field 
* contents 



end-of-file field 
contents 



To Diagram 
25.2.1 



DESCRIPTION 



MODULE/ 
ROUTINE 



2. As many as six error flags are set in a 2-byte indicator fi 

tions, and issues the appropriate error messages. 



jld. #MICR interrogates the error flag bytes after analysis of system and stacker specifica- 



Oiagram 25.2. #MICR Specifications Analysis, System Specifications 

9-8 



From Diagram 




I PROCESS i 



1 . Get stacker specification. 

2. Scan stacker number. Determine 
stacker address and add it to the 
compression group. Check for 
asterisk (continuation line for 
field comparison tests). Set 
error flag if field is invalid. 

Check validity and presence check 
fields for P, N, or blank. Build masks 
for valid and invalid field tests, and 
add them to the compression group. 
If continuation lines are specified 
(column 4), then validity and 
presence check fields must be blank. 
Set error flag if any field is invalid. 

Scan next comparison test field Check 
for length, or, if compression test is to 
be done, build corresponding test and 
add *t to compression group Set error 
flag if any fields are invalid. 

Check for another test field. If it 
has an entry, return to step 4. 



6. #MICR finishes building current 
compression group. 



• OUTPUT! 



^^ Error flags 

^^. Compression groups 



7 Check for more stacker specifications 
If there are more, return to step 1. 



To Diagram 

25.2.2 



Diagram 25.2.1. #MICR Specification Analysis, Stacker Specifications 
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PROCESS i 



1. Finish building compression group 
table 



*"S. 2. Move TAB01 through TAB05 to -MI08 
*| COMMON area 



3. U no error flags were sel, control 
returns to «M)08; otherwise, exit 
to diagram 25.3 to issue error 
messages. "IZZ7~^7~ZZ 



4. If control returns, exit to *MI08 
diagram 25.1.1, step 9. 



■OUTPUT! 



r 

_^> Compression groups 



^> sMI08 COMMON ar€ 
contents: 
TAB01 
TAB02 
TAB03 
TAB04 
TAB05 



~J^ Error messages 



To Diagram 
25.1 1 



Diagram 25.2.2. #MICR Specification Analysis, Cleanup and Error Logging 



9 10 



From Diagram 
25.2.2 



1_Z^> Error L 




1. «MICR cycles through error list 



2. Build and issue error message 
list. 



3. #MICR issues Type 2 message 

MIC 4975 requiring operator action. 

4. If option is selected, return 
control to »MICR diagram 25.2.2; 
otherwise, job is canceled 
(option 3). 



r 



OUTPUT! 



"" ^^ Syslog (any or all nf 
The following MICsi: 
4952 4953 4954 4955 
4956 4957 495S 4959 
4960 4961 4963 4963 



^_> Syslog (MIC 4975) 



To Diagram 
2S.2.2 



Figure 25.3. #MICR Specification Error Message Handler 



Method of Operation 9-1 1 



From Attachment Controller 
Run Code on 'End Transmission' 



Document status 



TAB05-Maximum 
document 
length 

Document length 

1255 input buffer 




TAB05 -Control/EOF 
field EOF 
document 
definition 

System formatted 
buffer 

TAB05 Control/EOF 
field 
—Control 
document 
definition 



■PROCESS! 




1. Clear formatted buffer to blanks. 

2. Check whether document was auto refected 
If true set A in column 1 of the formatted 
buffer; then exit to diagram 25.4.1, 

step 6. 

3. Check whether document had a panty 
error. If true, set P in column 1 of the 
formatted buffer; then exit to 
diagram 25.4.1, step 6. 

4. Check whether document caused a length 
overflow. If true, set 1 in column 1 of 
the formatted buffer; then exit to 
diagram 25.4.1, step 6. 

5. Format the input document, determine 
the field lengths, and set field 
validity indicators. 

6. Check for end offtle document. If 
present, set E in column 4 of the 
formatted buffer and set EOF indicator 
on; then exit to diagram 25.4.1, 

step 6. 

7. Check for control document. If present, 
exit to diagram 25.4.2, step 1 If this 

is not a control document, exit to 
diagram 25.4.1, step 1. 



• System formatted 
buffer 



—^^ Field lengths and field 
■ validity indicators 



—^^ Sense byte 



To Diagram 
25.4.1 or 25.4.2 



Diagram 25.4. Stacker Select Routine, Document Formatting and Status Analysis 
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TAB05-Modulus 
indicator 

Field validity 
indicators 

TAB01.TAB02, TAB03, 
Compression groups, 
system formatted 
buffer 



TAB01 En try -stacker " 
select code 



TAB01 Entry-stacker" 
number 



Document status _ 
TAB04 
TAB05 



From Diagram 
25.4 or 25.4.2 



$ check ■ ■ 



■ PROCESS! 



m 




1 . Check whether modulus check is specified. 
If true, exit. 

2. Convert the field validity indicator 
bits to characters, and move them to 

the formatted buffer, columns 5 ^^^^ 
through 9. 



3. Perform compression group tests to _ 
select the correct stacker. 



^> 



"^S- 4. Route document to specified stacker. 

1 



5. Move character code of stacker 



selected to formatted buffer, column 

2, and set Document to be Sent 
indicator. Control is returned to the 
attachment controller run control code 
(attach controller run control code). 



6. Select reject stacker; then returi 
to step 4. 



T» 

I Diagr 



r 



OUTPUT! 



"" ^^ Account number field 
I validity indicator 

■ System formatted buffer 



£> TAB01 entry 



J 



Document routed to 
specified stacker 



^^> Document to be Sent 
indicator set on 



"AB01 Reject stacker 
entry 



DESCRIPTION 



3. The compression group tests include validity and presence check, length test, comparison test, and alternate and stop on document count 

condition tests. 

4. 

5. 



MODULE/ 
ROUTINE 



Diagram 25.4.1 . Stacker Select Routine, Stacker Selection 
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TAB05— Document count 
condition action 



From Diagram 



Lr 



^> 



■ PROCESS i 



1 . Set C in column 4 of the formatted 
buffer. 

2. Check document count condition 
action for Indicate. If not 
present, exit to diagram 25.4, 1 , 
step 6. 

3. Check for indicate condition currently 
waiting to be processed. If none 
waiting, exit to diagram 25.4.1, 
step 6. 



4, Set C in column 4 of formatted 
buffer. 

5. Retrieve first entry waiting for the 
indicate queue 1TAB04) and remove 
queue entry. 



6. Reset the document count of the _ 
stacker specified by the queue entry 
to 0. 

7. Exit diagram 25.4.1, step 4. 




To Diagram 
25.4.1, Step 4 or € 



OUTPUT ■ 



System formatted 
buffer 



£^TAB01 entry 



Diagram 25.4.2. Stacker Select Routine, Control Document Processing 
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From Diagram 
25.4.1 



■ INPUT 



Field validity indicator 

bits 



Account field length 



~l Lp 

Jicator ^> 



System formatted 
document 



Modulus indicator 

Modulus wei 
factor 



Modulus lookup table ' 




rj 



■PROCESS i 



Check account number field validity 
indicator. !f it is off, or if the 
account field length is zero, go to 
step 8. 

2. Routine initializes field length, modulus 10 



■eater 1 I a 

^. LU 1 



modulus total, self-check digit, and the 
pointer to the account number field. 

Retrieve the next digit from account 
number. 

Retrieve the next digit from weight- 
ing factor. If it is a self-check 
digit, save account number digit 
and go to step 6. 

Use the weighting factor and the 
account number digits to look up 
modulus check digit, and add it to 
modulus total. 

Check for more digits in the account 
number field. If there are more digits, 
return to step 3. 

Modulus total is tested for match 
with self-check digit. If they match, 
exit. 



> 8. 



Set account number field validity ~ 
indicator off; then exit. 



Diagram 25.4.3. Modulus Check Routine 



3, 



■OUTPUT! 



Z^> Field validity 
indicator bits 



To Diagram 
25.4.1 



Method of Operation 9-1 5 



9-16 



Chapter 10. Program Organization 



The following routines comprise SUBR08. 



#MI08 



#MICR 

DIAGRAM: 25-2 
ENTRY POINT: #MICR 
FUNCTIONS: 

— Scans the 1255 array for the system and stacker 
specifications. 

— Builds tables that control SUBR08 from the informa- 
tion on the specifications. 

— Checks for possible errors. 
INPUT: 

— Array pointed to by the 1255 DTF 

— Fields being read 

— Modulus and weighting factor if the account number 
is to be verified 

— Document count condition 

— Control and end-of-file documents 
OUTPUT: 

— Compressed version of the system and stacker 
specifications 

— Set of pointers and indicators passed in the 1255 
array to SUBR08 

— SYSLOG list of system and stacker specification 
errors detected 

ROUTINES USED: 

— The EXIT routine is entered through the EXIT SVC. 

— If no errors are detected, control is returned to 
#MI08. 

— If errors are detected, #MICR logs the diagnostic 
warning message. 

EXITS: 

— Normal: To caller 

— Error: To #MICR (SYSLOG list) 



DIAGRAM: 2&-1.1 
ENTRY POINT: #MI08 

— BEGIN: Entry point from RPG II input routines 
FUNCTIONS: The module contains two subroutines: 

— Processing Section subroutine passes 55-byte records 
containing information from documents read from 
the 1255. 

— Stacker Select Section subroutine performs the 
calculations needed to stacker select the document at 
interrupt level 4 (end of read or sorter stopped). 

INPUT: 

— Compressed version of the system and stacker 
specifications 

— Set of pointers and indicators are received in storage 
from the transient #MICR of the 1255 

OUTPUT: To the RPG II or assembler input routine, 55- 
byte records containing the fields read, the stacker 
selected for the document, the type of document, 
and the number of each valid field (each field is 
present in the same order as on the document itself, 
and takes up the maximum space allowed on the 
document) 

ROUTINES USED: #STDDA (to load transient #MICR): 

— The #STDDA routine is entered through the 
SPECIAL device code 

— The address of the parameter list is passed in XR2 

— Parameter list contains an O to indicate the object 
library (6 bytes of library entry name (#MICR) and 
5 bytes unused) 

EXIT: Return to the next sequential instruction of the 
object program 
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Error Routine (Included as Part of #MICR) 

DIAGRAM: 25.3 

ENTRY POINT: #MICR - specification analysis 
FUNCTION: Issues the error message for SUBR08. 
INPUT: XR2 contains the buffer address and the first 2 

bytes of the buffer contain the error flags 
OUTPUT: The following message: 

SCP 4975 DMMI OPTIONS (0 3) ? 

ABOVE ERROR (S> INDICATE SPEC ERROR (S) 
ROUTINES USED: 

- SYSLOG - The parameter list and message is placed 
in the buffer 

- #MICR - Control is returned to #MI08 
EXIT: T0SUBRO8 



Modulus Check Subroutine #MICR 

DIAGRAM: 25.4.3 

ENTRY POINT: #MICR 

FUNCTION: Performs modulus checking as indicated on 
the system specification. If the self-check digit of the 
account number field does not compare, turns off the 
account number field validity bit in the document 
buffer. 

INPUT: 

— Index register 1 points to the leftmost byte of the 
document in the document buffer area 

— Index register 2 points to the rightmost byte 
OUTPUT: 

— If the modulus check is successful, the account 
number validity bit is left on 

— If the modulus check is unsuccessful, the validity 
bit is turned off 

EXIT: To the next sequential instruction in SUBR08 
stacker select section 
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Module 



Chapter 11. Directory 



Name 


Diagram 


Descriptive Name 


#MICR 


25.2.1 


Build transient for 
SUBR08 


#MICR 


25.2.2 


Stacker select section 
(1255) 


#MI08 


25.1.1 


Process section (1255 



Entry 
Point 

#MI08 



Function 

Scans the 1255 array for the system specification 
and the stacker specification 

Performs the calculations needed to stacker- 
select the document 

Passes 55-byte records containing information 
taken from documents read from the 1255. 



Data management 



SUBR08 Interfaces between user program and the 1255 

attachment 



Directory 11-1 
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Chapter 12. Data Areas 



The DTF and IOB generated for the Magnetic Character 
Reader are the interface between the user program and 
MICR. The MICR work area, consisting of the constants, 
table and work area, and the input and output buffer 
formats, are located in the attachment controller. See 
Figures 12-3 and 12-4 for an overview layout of the attach- 
ment controller area. For a description of the system 
communications area, program level communications area, 
MICR error history table, system trace area, syslog param- 
eter list, and MICR error counter and SIO counter tables, 
see IBM System/32 System Data Areas and Diagnostic Aids, 
SY21-0532. 



DTF 

The MICR DTF is the primary interface between the user's 
program and MICR. The user's program generates a DTF 
for each MICR file (Figure 12-1). Field NPDTF@ (hex OB 
and OC) in the program level communications area contains 
the address of the first DTF on the chain. To find the next 
DTF in the chain, refer to the chain field in the appropriate 
DTF. End of chain is indicated by hex FFFF. XR2 points 
to the specified DTF when a data management function is 
invoked. 



Data Areas 1 2-1 



Disp of 








Leftmost 




Lng in 




Byte in 




Bytes 




Hex 


Label 


in Dec 


Description 



00 


SPCDEVC 


1 


01 


SPCUPSI 


1 


02 


SPCATTR1 


2 



04 


SPCRSV1 


2 


06 


SPCCHAIN 


2 


08 


SPCRSV2 


2 


0A 


SPCRSV3 


2 


OC 


SPCLRADD 


2 


0E 


SPCCODE 


1 



OF 



SPCCOMMD 



10 


SPCINADD 


2 


12 


SPCOUTAD 


2 


14 


SPCBLGTH 


2 


16 


SPCRLGTH 


2 


4 rt 

IO 


5PCARRAY 


2 



Device code. Caller assigns an X'00', internally assigned an X'52' 

External switches (UPSI) checked by open routine 

File attributes: 

Byte 0: 

X'80' = input file 
X'08' = dual I/O buffer 
X'01' = file opened 

Byte 1 : Reserved 

DTF chain pointer A: Backward address of previous DTF in chain 
(X'FFFF' if first in chain) 

DTF chain pointer B: Forward address of next DTF in chain (X'FFFF' 
if end of chain) 

ARR save area 

X R 1 save area 

The leftmost byte address of the current record passed to the caller 

Completion code. Set by subroutine before returning to caller: 

X'40' = normal completion 
X'41 ' = controlled cancel 
X'42' = end of file 

Command byte issued by caller: 

X'80' = read record 
X'10' = close file 

Input I/O address of the I/O buffer to be used by the subroutine 

Reserved 

Block length: Multiple of record length (minimum 550, maximum 
4070) 

Record length: Must be 55 

Address of array DTT 



Figure 12-1. Format of Magnetic Character Reader DTF 
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IOB 



MICR lOBs are input control blocks used for controlling 
data sent to the System/32 from the Magnetic Ink Charac- 
ter Reader. The user's program allocates, via SUBR08, 
space for the lOBs and an I/O buffer area. MICR formats 
the allocated area into three identical lOBs, each 12 bytes 
long (Figure 12-2). 



Note: When coding an assembler program it is the responsi- 
bility of the programmer to ensure that main storage address 
2 in the IOB (IOBM@2) is large enough to contain the end 
address of the buffer. That is, the R code (IOBMRC) times 
55 must fit between address 1 and address 2. This is speci- 
fied by hex 53 (a single document request) and hex 51 (get 
document request). 



If data management is the caller, the DTF normally points 
to the IOB. Active lOBs (indicated by the system queue 
headers starting at main storage location hex 500) can be 
chained; bytes and 1 of the IOB point to the next IOB on 
the chain. When IOS or wait is called, XR1 must contain 
the IOB address. 



Disp of 








Leftmost 




Lng in 




Byte in 




Bytes 




Hex 


Label 


in Dec 


Description 



00 
02 



IOBMCH@ 
IOBMCC 



Chain address of next IOB in queue 



Completion code; posted by caller microcode 



X'80' = IOB active 

X'41' = Error in processing IOB request 
X'40' = IOB processing complete 

X'10' = Count flag (indicates R code has been added to the running 
total) 



03 



IOBMQC 



QByte: 



X'56' = Load compressed specifications in work area 

X'54' = Load device run, stacker select, and modulus check code 

X'53' = Single document request 

X'52' = Load diagnostic code 

X'51' = Get document request 



04 



IOBMRC 



R Byte: contents of this byte corresponds to status of field IOBMQC 



X'56' = '00'— compression group 

'02'— work area 
X'54' = Number of sectors of microcode to load 
X'53' = Number of documents to be read 
X'52' = Number of sectors of microcode to load 
X'51 ' = Number of documents to be read 



Figure 12-2 (Part 1 of 2). Format of Magnetic Character Reader IOB 
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Disp of 
Leftmost 
Byte in 
Hex 



Label 



Lng in 
Bytes 
in Dec 



05 



IOBMSB 



1 



Description 



Sense byte 1 : 



06 



IOBM@1 



08 



IOBM@2 



X'80' = 



X'40' 
X'20' = 
X'10' = 
X'08' = 
X'04' = 
X'02' = 
X'01' = 



Bring up diagnostic error 

Note: The rightmost byte of control store location X'004B' 

contains the number of the failing diagnostic. The leftmost 

byte is XW. 

Document count condition reached 

Reserved 

Attachment controller DBO/DBI parity check 

External I/O light 

Attachment controller memory parity check 

Attachment controller long timeout 

Sorter stopped 



0A 



IOBMSB2 



Data buffer; address contents description corresponds to field IOBMQC: 

X'56' = Start of compression or work area in main storage 
X'54' = Main storage address to use as I/O buffer in loading micro- 
code into attachment controller 
X'53' = Main storage address of area to read document into 
X'52' = Main storage address to use as I/O buffer in loading micro- 
code into attachment controller 
X'51' = Main storage address of area to read document into 

Data buffer; address contents description corresponds to field IOBMQC: 

X'56' = End of compression or work area in main storage 
X'54' = Disk address of microcode to be loaded into attachment 

controller 
X'53' = End address of buffer 
X'52' = Disk address of microcode to be loaded into attachment 

controller 
X'51 ' = End address of buffer 

Sense byte 2: 



OB 



IOBMRSVD 



X'80' = Document auto rejected 

X'40' = Reserved 

X'20'= Misread with reject 

X'10'= Misread without reject 

X'08' = Reserved 

X'04' = Reserved 

X'02' = Reserved 

X'01'= Reserved 

Reserved 



Figure 12-2 (Part 2 of 2). Format of Magnetic Character Reader IOB 
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Direct 
Area 



Address of 




Leftmost 




Byte in 




Hex 


Contents 


0000 


Start/restart routine 


0004 


Link to interrupt handier, reserved direct area 


0100 


Attachment controller constants, table and work area. Figure 12-4 


0200 


System/32 output buffers. Figure 12-10 


0300 


1255 input buffers, Figure 1 2-1 1 


0337 


Stacker decision compression groups. Figure 12-12 


0900 


Modulus check code 




Stacker select code 


1000 


MICR run code interrupt handler 


17FF 





Dump 
Area 
<2K) 



Figure 12-3. Overview of Attachment Controller Storage Organization 



Address of 




Leftmost 




Byte in 




Hex 


Contents 


0100 


Stacker type table (TAB01), Figure 12-5 


0134 


Field description table (TAB02), Figure 12-6 


0139 


Alternate count condition table (TAB03), Figure 12-7 


01 3C 


Unused 


013F 


Indicate count condition table (TAB04), Figure 12-8 


0150 


System specification constants (TAB05), Figure 12-9 


01 7A 


Programming and engineering constant and work area 


01FF 


End of constant and work area 



Figure 12-4. Overview of Attachment Controller Constants, Tables, and Work Area 
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1255 Model 1 or 2 



Entry for 
stacker 




Entry for 
stacker 


Entry for 
stacker 1 


Entry for 
stacker 2 


Entry for 
stacker 2 


Entry for 
stacker 4 


Entry for 
stacker 3 


Entry for 
stacker 6 


Entry for 
stacker 4 


Entry for 
stacker 8 


Entry for 
stacker R 


Entry for 
stacker R 



There is one entry in TAB01 for 
each stacker. The entries are 
arranged in one of the three 
sequences shown above, depend- 
ing on how the stackers of the 
1255 are numbered. TAB01 is 
located at hex 0100 in the 
attachment controller. 



1255 Model 3 



Entry for 
stacker 



Entry for 
stacker 1 



Entry for 
stacker 2 



Entry for 
stacker 3 



Entry for 
stacker 4 



Entry for 
stacker 5 



Entry for 
stacker 6 



Entry for 
stacker 7 



Entry for 
stacker 8 



Entry for 
stacker 9 



Entry for 
stacker A 



Reserved 



Entry for 
stacker R 



Stacker 




Number 


Code 





10 


1 


20 


2 


30 


3 


40 


4 


50 


5 


60 


6 


70 


7 


80 


8 


90 


9 


A0 


A 


CO 


R 


B0 



Length 
in Bytes 


/ 

Explanation J 


1 


Stacker number in EBCDIC f^ 


1 


Stacker select code 


2 


Intermediate document count total (used 
only by the stacker select section) 



Each stacker entry (except the reject stacker) in TAB01 
is set up as shown above. The reject entry contains only 
the stacker number and the stacker select code. 



Figure 12-5. Common Data — Stacker Type Table (TAB01) 
12-6 



Field type 
table TAB02 
(5 bytes) 



Entry for field 1 
(1 byte) 



Entry for field 2 
(1 byte) 



Entry for field 3 
(1 byte) 



Entry for field 4 
(1 byte) 



Entry for field 5 
(1 byte) 




Length of field in hex. If field is variable 
length, this is the maximum field length 
(maximum length X'B'). 



Note: Field description specifies the length of the field. It 
occupies bits through 3 of the byte and contains one of 
the following hex values: 

4 = Field is not to be read 

C = Fixed length field 

E = Variable length field 
TAB02 is located at hex 0134 in the attachment controller. 



Figure 12-6. Common Data — Field Description Table (TAB02) 



Byte 



2-3 



Explanation 



Address (low-order byte) of the TAB01 entry 
of the stacker currently being used (see Note) 

Intermediate document count used by the 
stacker select section 



When the alternate action is specified on a document count 
condition, this table is used to route the document to the 
proper stacker in the alternate sequence. The intermediate 
document count is used to determine when the next stacker 
in the alternate sequence should be used. TAB03 is located 
at hex 0139 in the attachment controller. 



Note: The address of the TAB01 entry is the low-order 
byte of the address. All TAB01 entries are on the same 
attachment controller storage page boundary and are 
loaded with a constant high-order byte. 



Figure 12-7. Common Data — Alternate Document Count 
Condition Table (TAB03) 
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/8 high-order 
constant bits 



i 



// 


Queue Header 




Queue entry 1 




Queue entry 2 




Queue entry 3 




Queue entry 4 




Queue entry 5 




Queue entry 6 




Queue entry 7 




Queue entry 8 




Queue entry 9 




Queue entry 10 




Queue entry 1 1 




Queue entry 12 




Queue entry 13 




Queue entry 14 




Queue entry 1 5 




Queue entry 16 



The TAB04 table is used only if the action 
for the document count condition is specified 
as indicate. TAB04 is located at hex 01 3F 
in the attachment controller. 



Figure 12-8. Common Data — Indicate Document Count Condition 
Table (TAB04) 



Address of next 
queue entry to 
, be used for in- 
dicate condition 



3 ! 4 



Address of next / 
unused queue 
entry 



<. Address of TAB01 entry for 
stacker meeting indicate condition 



The address of next unused queue entry is the 4 low-order 
bits of the address. Since the TAB04 queue entry table is 
aligned on a 2-byte attachment controller storage boundary, 
the 8 high-order bits are constant and are loaded separately. 
The composite address formed is of the queue entry to be 
used when the next indicate condition occurs. 

The address of next indicate condition queue entry is iden- 
tical to the above address in format. The combined address 
formed points to the queue entry to be used to stacker 
select the next control document. 

The address of the TAB01 entry has the same format as the 
similar field in the TAB03 control block. The composite 
address formed points to the TAB01 entry for a stacker 
that has met the document count condition. 



The TAB04 queue header is initialized to hex 00 to indicate 
an empty queue. If both halves of theTAB04 queue header 
are equal, the queue is empty; otherwise at least one queue 



ArAr-otcon 



Queue overflow can never occur because there are fewer 
stackers than queue entries. 
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The document count condition action, control/EOF doc- 
ument field length, modulus check indicator and weighting 
factor, and the control and end-of-f ile document definition 
fields are the same fields that appear on the system specifi- 
cations. The fields marked in hexadecimal are converted 
from character to binary. 

The 6 reserved bytes are present to prevent the control anu 
end-of-f ile document definition fields from crossing any 
attachment controller 2-byte storage boundary. TAB05 is 
located at hex 0150 in the attachment controller. 



Address of 
Leftmost 
Byte in 
Hex 



0150 



Lng in 
Bytes 
in Dec 



Description 



Document count condition limit (in 
hex) 

Document count condition action 

Displacement to control/EOF fields 

Control/EOF document field length 

(in hex) 

Modulus check indicator 

Modulus check weighting factor 

Reserved 

Control document definition field 

End-of-f ile document definition 
field 

Account number end position 

Account number field length 

Process control field length 



Figure 12-9. Common Data — System Specification Constants 
(TAB05I 



0152 


1 


0153 


1 


0154 


1 


0155 


1 


0156 


10 


0160 


6 


0166 


10 


0170 


10 


01 7A 


1 


017B 


1 


017C 


1 



The 256-byte output buffer area is formatted to four 64- 
byte buffers, each of which contains a 55-byte formatted 
document to be sent to the caller. 

The data delimiter is used to separate the data from the 
sense-byte information when the document is being trans- 
mitted to the caller. The attachment controller sense byte 
contains values describing the state of the 1255 and/or the 
document being sent to the caller. The output buffers start 
at location hex 0200 in the attachment controller. 



Address of 
Leftmost 
Byte in 
Hex 


Lng in 
Bytes 
in Dec 


Description 


0200 

0237 
0238 


55 

1 

1 


Formatted document to be sent to 
the caller 

Data delimiter (constant X'00') 

Attachment controller sense byte 1: 



0239 



023A 



X'80' = Reserved 

X'40' = Document count limit 

reached 
X'20' = End-of-f ile 
X'10' = Attachment controller 

DBO/DBI parity check 
X'08' = External I/O light 
X'04' = Reserved 
X'02' = Reserved 
X'01 ' = Sorter is stopped 

Attachment controller sense byte 2: 

X'80' = Document autorejected 

X'40' = Reserved 

X'20' = Misread with reject 

X'10' = Misread without reject 

X'08' = Reserved- 

X'04' = Reserved 

X'02' = Reserved 

X'01 ' = Reserved 

Unused 



Figure 12-10. Caller's Output Buffers 
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The buffer length is equal to the maximum number of char- 
acters it is possible to receive from the 1 255 for a single 
document (45 digits plus 8 delimiters). The input buffer 
is located at hex 0300 in the attachment controller. 



Address 






of Left- 


Lng in 




most Byte 


Bytes 




in Hex 


in Dec 


Description 



0300 55 Contains the characters (digits and 

delimiters) received from the 1255 
during the transmission of a 
document 

Figure 12-11. 1255 Input Buffer 
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Compression Group Format 

Compression is composed of compression groups. One 
compression group is created for each stacker specification. 
Compression groups are in the same order as the corres- 
ponding stacker specifications. These compressions overlay 
the array. Compression groups start at location hex 0337 



Compression 
group 1 



Compression 
group 2 



Compression 
group 3 



Compression 
group 4 



Compression 
group 5 



Compression 
group N 



Flag 



Byte 


Explanation 





Length of this compres- 
sion group in hex 


1 


Address of the TAB01 
entry for this stacker 
(last byte of the address) 


2-n 


Tests from the specifica- 
tion appears here. There 
may be from 0-5 tests. 
If a validity or presence 
check is specified, it will 
appear first. 
Test Mask Values: 
01 = Equal to (E) 
02= Greater than (G) 
03= Not less than (NL) 
04= Less than (L) 

05 = Not greater than 

(NG) 

06 = Not equal to (NE) 


n+1 


End-of-compression 
group flag equals X'FF'. 



Validity 
presence 
check 



Field 

length " 
test 



Field 

comparison 

test 



A 1-byte flag equal to X'FE' marks 
the end of compression. If the 
alternate document count condi- 
tion action is specified, this flag is 
X'AA'. 



■ 
Byte 


Bit Explanation 





0-3 Displacement = X'0' (for branching 
table) 


1 


0-7 Mask byte for field indicators of 
fields required to be invalid or not 
present 


2 


0-7 Mask byte for field indicators of 
fields required to be valid and 
present 



Byte 


Bit 


Explanation 





0-3 


Displacement = X'2' (for branching 
table) 





4-7 


Field number (number of the field 
on a document, through 5) 


1 


0-3 


Required length of the field 


1 


4-7 


Mask byte indicating what condi- 
tion will satisfy the test (equal to, 
greater than, etc) 



Byte 


Bit 


Explanation 





0-3 


Displacement = X'4' (for branching 
table) 





4-7 


Field number (number of the field 
on a document, through 5) 


1 


0-3 


Field position of the first (ieftmost) 
digit that is compared (rightmost 
digit of field isO) 


1 


4-7 


Mask byte indicating what condi- 
tion will satisfy the test (equal to, 
greater than, etc) 


2 


0-7 


Length of test field 


3-m 


Test field (comparison characters 
from the specifications) 



Figure 12-12. Compression 
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Chapter 13. Diagnostic Aids 



The 1255 Magnetic Character Reader has an attachment 
controller dump and nonoverlap mode capability. Refer 
to the IBM System/32 Data Areas and Diagnostic Aids, 
SY21-0532, for detailed information on the system dump 
facility and other diagnostic aids. 



ATTACHMENT CONTROLLER DUMP 

When errors occur, system information can be saved on the 
CE cylinder. When the system diagnoses an abnormal ter- 
mination error (invalid address, invalid op code, or invalid 
Q code), the contents of all of main storage, all of control 
storage, and the last 20 sectors of the scheduler work area 
(SWA) history file are automatically written to the CE 
cylinder. The 1255 attachment controller (9 sectors) is 
also dumped to the additional main storage area following 
the SWA. See Figure 13-1 for attachment controller con- 
tents that are dumped. This is the same area used for the 
additional control storage and the additional main storage. 



SWA 


9 Sectors 
Attachment 
Controller 
Storage 


All of 

Control 

Storage 


20 Sectors 

History 

File 


All of 

Main 

Storage 


First 

Library 

Member 



Direct 
Area 



X'OOOO' 


Start/restart routine 


X'0004' 


Link to interrupt handler 




Reserved direct area 


X'0100' 


Constant, table, and work area 


X'0200' 


System/32 output buffers (reformatted) 


X'0300' 


1255 input buffers 


X'0337' 


Compression groups 


X'08FF' 




X'0900' 


Modulus check code 




Stacker select code 


X'1000' 


MICR run code 




Interrupt handler 


X'17FF' 





Dump 
Area 
(2K) 



Figure 13-1. Attachment Controller Content That is Dumped 
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The attachment controller dump is invoked the same three 
ways that a System/32 control and main storage dump is 
requested: 

• Branch to main storage address hex 0000 

• Press R ESET and then CE START on the CE console 

• Take a D option to a formatted message display 

You can specify a dump for the attachment controller by 
specifying MICR as the list option following the // DUMP 
LIST control statement. The following OCL statements 
load a dump: 

// LOADSFEDMP 

//RUN 

The // DUMP control statement then requests the dump 
options: 



// DUMP LIST - s 



main 

control 

disk 

ptf 

config 

history 

MICR 



, .OUTPUT 



I printer | 



INPUT - { pp 



Example of Attachment Controller Dump 

Figure 13-2 shows the contents of an attachment controller 
dump with pertinent locations indicated. 



System Status Byte 2 

A hex FF in byte 00 (location hex 0000) indicates an error 
occurred during the attachment controller dump. If byte 
00 contains a hex FF, the next byte (hex 0001) contains 
the attachment status byte 2. The attachment controller 
dump error is indicated by the status of bit 5 in status byte 
2. If bit 5 is on, the dump error was caused by an attach- 
ment controller memory parity check, and if bit 5 is off, 
the dump error was caused by an attachment long time-out 
check. Following are the bit offsets that are indicated by 
the attachment status byte 2: 



Offset 
X'80' 
X'40' 
X'20' 
X'10' 

X'08' 
X'04' 



X'02' 

x'or 



Meaning 

Attachment controller busy 

Transfer mode 

Command pending 

Attachment controller DBO/DBI parity 
check 

Set system micro-interrupt request 

On — Attachment controller memory 
parity check 

Off — Attachment controller long 
time-out check 

Enable long timeout 

Service required 



Note: If an attachment controller dump error is indicated 
(bit 5), run hardware diagnostics for the MICR attachment 
to determine the malfunction. 



Input Buffer Delimiter 

A delimiter of hex 00 is inserted by the controller to indi- 
cate the end of document data for the 1255 input buffers. 
The buffer is loaded from right to left starting at location 
hex 0336. 
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Address Table 

The first 2 bytes of the 16-byte address table (location hex 
01 DO) contains the address to the stacker compression 
groups. The next 2 bytes (location hex 01 D2) point to the 
stacker work area (table 02). The remainder of the table is 
not used. 



Release Number 

The release number (location hex 01 FE) is the current 
release level of the attachment controller microcode. 



Work Registers 

The attachment controller registers (location hex 01 E0) are 
used by the attachment controller as a work area and save 
area. They are dumped to the controller storage (location 
hex 01 E0) during a controller dump. 



Attachment Controller Status Indicators 

The eleven 1-byte attachment controller status indicators are 
located in the attachment controller at location hex 01 9A. 
Following are the values and offsets for the indicators: 



Address of 








Leftmost 




Lng in 




Byte in 




Bytes 




Hex 


Label 


in Dec 


Description 



019A 



RUNSTAT 



Run status byte: 



X'80' = Sorter is stopped 
X'40' = Record to transfer 
X'20' = End-of-file flag 
X'10'= Stop flag 
X'08' = Dump flag 
X'04' = Not used 
X'02' = Not used 
X'01 ' = Not used 



019B 



INTBYTE 



Interrupt status byte: 



X'80' = End transmission flag 
X'40' = Interrupt flag 
X'20' = Not used 
X'10'= Not used 
X'08' = 1255 data parity check 
X'04' = DBO/DBI parity check 
X'02'= Not used 
X'01 ' = Not used 



Diagnostic Aids 13-3 



Address of 








Leftmost 




Lng in 




Byte in 




Bytes 




Hex 


Label 


in Dec 


Description 



01 9C 



CURCMD 



Current command byte: 



X'80' = Not used 
X'40' = Dump command 
X'22' = Load work area 
X'20' = Load compression area 
X'12' = Normal read request 
X'1 1 ' = Single document request 
X'08' = Not used 
X'04' = Not used 
X'02' = Not used 
X'01'= Not used 
X'00' = Wait command 



019D 



DEVCMD 



019E 


INBUF@LO 


1 


01 9F 


NRS@LO 


1 


01 A0 


NRF@LO 


1 


01 A1 


DOCINFO 


i 



Device command byte: 

X'80' = CPU is stopped 
X'40'= Read call 
X'20'= I/O disconnect 
X'10'= Engage 
X'08' = Disengage 
X'04' = Not used 
X'02' = Not used 
X'01'= Not used 

1255 input buffer address (low) 

Next record to send address (low) 

Next record to format address (low) 

Document status byte: 

X'80' = Auto select 
X'40' = Amount control field valid 
X'20' = Process control field valid 
X'10' = Account field valid 
X'08' = Transit routing field valid 
X'04' = Serial number field valid 
X'02'= Field 6 valid 
X'01'= Field 7 valid 



01 A2 


DOCLEN 


1 


Document length 


01 A3 


TAB01PTR 


1 


Table 01 pointer 


01 A4 


MISREADS 


1 


Misread flag save byte 
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Attachment Controller Status Indicators 
Pointer to Last Entry Traced 
Command/Sense Trace Buffer 
Address Table 
DAR Reg Save 
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Figure 13-2. Contents of an Attachment Controller Dump 
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Attachment Controller Trace Buffer 

The 16-byte attachment controller trace buffer maintains 
a history log of all commands issued to the attachment 
controller by the system. The number of commands saved 
depends on the type of command issued and the sense byte 
status that is logged. Each logged command is preceded by 
a 1-byte command identifier (hex FF). When searching the 
trace buffer, reference location hex 01 B3 in the attachment 
controller dump for the pointer to the latest entry in the 
trace buffer. Starting from the last entry logged, continue 
backward to the first command identifier (hex FF). This 
is the start of the latest entry logged. To find the next 
latest entry, continue backward through the trace buffer 
to the next command identifier. Continue this process 
until a complete wraparound to the byte pointed to from 
the iast entry pointer is reached. The trace function is 
always active. 



FF 


Command identifier 


00 


Wait command 


FF 


Command identifier 


12 


Read command (normal) 


04 


No data sense (acknowledge) 


00 


Sense byte 1 


00 


Sense byte 2 


FF 


Command modifier 


00 


Wait command 


FF 


Command modifier 


12 


Read command (normal) 


04 


No data sense (acknowledge) 


00 


Sense byte 1 


00 


Sense byte 2 


FF 


Command modifier 


00 


Wait command 



Figure 13-2 shows the location, and last entry pointer, for 
the attachment controller trace buffer. Figure 13-3 is an 
explanation of the entries in the attachment controller 
trace buffer. 



NONOVER LAP MODE 

In conjunction with the dump facility, it is possible to read 
documents one at a time from the 1255. This capability 
allows the service representative to: 

• See a document as read from the 1 255 

• See a document as it is reformatted by the stacker select 
routine within the attachment controller 

• See the document in System/32 main storage as received 
from the attachment controller 

To invoke the nonoverlap mode, use the SETMICR pro- 
cedure and specify the CYCLE-Y/N parameter. The 
SETMICR command statement format is: 



SETMICR 



CYCLE 



N) 



Cycle-Y The 1255 Magnetic Character Reader disen- 
gages after reading each document. 

Cycle-N The 1255 Magnetic Character Reader does not 
disengage after reading each document. 

See the IBM System/32 System Control Programming 
Reference Manual, GC21-7593, for additional information 
about procedures and OCL statements. 



Figure 13-3. Explanation of Attachment Controller Trace 
Buffer Entries 
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